# 拼接<a name="ZH-CN_TOPIC_0000002441657601"></a>






## 概述<a name="ZH-CN_TOPIC_0000002408258078"></a>

AVS（Any View Stitching，全景拼接）实现的功能：对多路图像进行全景拼接，并且按照指定的投影模式输出图像。整个拼接过程主要包括标定以及拼接输出。本章节主要描述拼接输出部分。另外，AVS也支持水平、垂直或者田字形的非融合拼接。

>![](public_sys-resources/icon-notice.gif) **须知：** 
>本章仅SS928V100/SS927V100支持此模块。

## 功能描述<a name="ZH-CN_TOPIC_0000002408098162"></a>


### 基本概念<a name="ZH-CN_TOPIC_0000002441697457"></a>

-   GROUP

    AVS对用户提供组（GROUP）的概念。最大可用数为[OT\_AVS\_MAX\_GRP\_NUM](OT_AVS_MAX_GRP_NUM.md)个，各GROUP分时复用AVS硬件。每个AVS GROUP包含多个PIPE和多个通道。

-   PIPE

    AVS组的PIPE。用于输入拼接源图像。PIPE的数目即拼接路数。用户可以通过系统绑定和前端相连或者发送图像到PIPE中拼接。

-   CHANNEL

    AVS组的通道。用于输出拼接的结果图像。其中通道0为拼接输出的原图，其他通道是通道0的缩小图，缩小最大倍数为15倍。

-   投影

    将全景空间图像投影到平面坐标中用于编码和传输。AVS支持的投影模式有Equirectangular、Cylindrical、Rectilinear和Cube map四种投影模式。

## API参考<a name="ZH-CN_TOPIC_0000002441697421"></a>

该功能模块为用户提供以下MPI：

-   [ss\_mpi\_avs\_create\_grp](ss_mpi_avs_create_grp.md)：创建一个AVS GROUP。
-   [ss\_mpi\_avs\_destroy\_grp](ss_mpi_avs_destroy_grp.md)：销毁一个AVS GROUP。
-   [ss\_mpi\_avs\_start\_grp](ss_mpi_avs_start_grp.md)：启用AVS GROUP。
-   [ss\_mpi\_avs\_stop\_grp](ss_mpi_avs_stop_grp.md)：禁用AVS GROUP。
-   [ss\_mpi\_avs\_reset\_grp](ss_mpi_avs_reset_grp.md)：重置AVS GROUP。
-   [ss\_mpi\_avs\_close\_fd](ss_mpi_avs_close_fd.md)：关闭组和通道的文件描述符。
-   [ss\_mpi\_avs\_get\_grp\_attr](ss_mpi_avs_get_grp_attr.md)：获取AVS GROUP属性。
-   [ss\_mpi\_avs\_set\_grp\_attr](ss_mpi_avs_set_grp_attr.md)：设置AVS GROUP属性。
-   [ss\_mpi\_avs\_send\_pipe\_frame](ss_mpi_avs_send_pipe_frame.md)：用户向AVS GROUP上的PIPE发送图像。
-   [ss\_mpi\_avs\_get\_pipe\_frame](ss_mpi_avs_get_pipe_frame.md)：用户从AVS GROUP上的PIPE获取一帧原始图像。
-   [ss\_mpi\_avs\_release\_pipe\_frame](ss_mpi_avs_release_pipe_frame.md)：用户释放一帧原始图像。
-   [ss\_mpi\_avs\_set\_chn\_attr](ss_mpi_avs_set_chn_attr.md)：设置AVS通道属性。
-   [ss\_mpi\_avs\_get\_chn\_attr](ss_mpi_avs_get_chn_attr.md)：获取AVS通道属性。
-   [ss\_mpi\_avs\_enable\_chn](ss_mpi_avs_enable_chn.md)：启用AVS通道。
-   [ss\_mpi\_avs\_disable\_chn](ss_mpi_avs_disable_chn.md)：禁用AVS通道。
-   [ss\_mpi\_avs\_get\_chn\_frame](ss_mpi_avs_get_chn_frame.md)：用户获取一帧通道图像。
-   [ss\_mpi\_avs\_release\_chn\_frame](ss_mpi_avs_release_chn_frame.md)：用户释放一帧通道图像。
-   [ss\_mpi\_avs\_get\_mod\_param](ss_mpi_avs_get_mod_param.md)：获取AVS模块参数。
-   [ss\_mpi\_avs\_set\_mod\_param](ss_mpi_avs_set_mod_param.md)：设置AVS模块参数。




















### ss\_mpi\_avs\_create\_grp<a name="ZH-CN_TOPIC_0000002441697577"></a>

【描述】

创建一个AVS GROUP。

【语法】

```
td_s32 ss_mpi_avs_create_grp(ot_avs_grp grp, const ot_avs_grp_attr *grp_attr);
```

【参数】

<a name="table1913mcpsimp"></a>
<table><thead align="left"><tr id="row1919mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p1921mcpsimp"><a name="p1921mcpsimp"></a><a name="p1921mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p1923mcpsimp"><a name="p1923mcpsimp"></a><a name="p1923mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p1925mcpsimp"><a name="p1925mcpsimp"></a><a name="p1925mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row1927mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p1929mcpsimp"><a name="p1929mcpsimp"></a><a name="p1929mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p1931mcpsimp"><a name="p1931mcpsimp"></a><a name="p1931mcpsimp"></a>AVS GROUP号。</p>
<p id="p1932mcpsimp"><a name="p1932mcpsimp"></a><a name="p1932mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p1935mcpsimp"><a name="p1935mcpsimp"></a><a name="p1935mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row1936mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p1938mcpsimp"><a name="p1938mcpsimp"></a><a name="p1938mcpsimp"></a>grp_attr</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p1940mcpsimp"><a name="p1940mcpsimp"></a><a name="p1940mcpsimp"></a>AVS GROUP属性指针。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p1942mcpsimp"><a name="p1942mcpsimp"></a><a name="p1942mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table1944mcpsimp"></a>
<table><thead align="left"><tr id="row1949mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p1951mcpsimp"><a name="p1951mcpsimp"></a><a name="p1951mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p1953mcpsimp"><a name="p1953mcpsimp"></a><a name="p1953mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1955mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1957mcpsimp"><a name="p1957mcpsimp"></a><a name="p1957mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1959mcpsimp"><a name="p1959mcpsimp"></a><a name="p1959mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row1960mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1962mcpsimp"><a name="p1962mcpsimp"></a><a name="p1962mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1964mcpsimp"><a name="p1964mcpsimp"></a><a name="p1964mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

组不支持重复创建。

各模式下对输入图像的要求如[表1](#_Ref480816971)所示。

**表 1**  各模式下对输入图像的要求

<a name="_Ref480816971"></a>
<table><thead align="left"><tr id="row1982mcpsimp"><th class="cellrowborder" rowspan="2" valign="top" id="mcps1.2.5.1.1"><p id="p1984mcpsimp"><a name="p1984mcpsimp"></a><a name="p1984mcpsimp"></a>属性</p>
</th>
<th class="cellrowborder" colspan="3" valign="top" id="mcps1.2.5.1.2"><p id="p1986mcpsimp"><a name="p1986mcpsimp"></a><a name="p1986mcpsimp"></a>模式</p>
</th>
</tr>
<tr id="row1987mcpsimp"><th class="cellrowborder" valign="top" id="mcps1.2.5.2.1"><p id="p1989mcpsimp"><a name="p1989mcpsimp"></a><a name="p1989mcpsimp"></a>BLEND</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.5.2.2"><p id="p1991mcpsimp"><a name="p1991mcpsimp"></a><a name="p1991mcpsimp"></a>NOBLEND_VER</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.5.2.3"><p id="p1993mcpsimp"><a name="p1993mcpsimp"></a><a name="p1993mcpsimp"></a>NOBLEND_HOR/NOBLEND_QR</p>
</th>
</tr>
</thead>
<tbody><tr id="row1995mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p1997mcpsimp"><a name="p1997mcpsimp"></a><a name="p1997mcpsimp"></a>宽高</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p1999mcpsimp"><a name="p1999mcpsimp"></a><a name="p1999mcpsimp"></a>各路图像宽高相同，并须4对齐。</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2001mcpsimp"><a name="p2001mcpsimp"></a><a name="p2001mcpsimp"></a>各路图像宽高相同，并须2对齐。</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2003mcpsimp"><a name="p2003mcpsimp"></a><a name="p2003mcpsimp"></a>各路图像宽高相同，并须2对齐。</p>
</td>
</tr>
<tr id="row2004mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p2006mcpsimp"><a name="p2006mcpsimp"></a><a name="p2006mcpsimp"></a>Stride</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p2008mcpsimp"><a name="p2008mcpsimp"></a><a name="p2008mcpsimp"></a>输入图像的stride的须256对齐，并且各路图像的stride须相等。</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2010mcpsimp"><a name="p2010mcpsimp"></a><a name="p2010mcpsimp"></a>各路图像的stride不要求相等，要求16对齐。</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2012mcpsimp"><a name="p2012mcpsimp"></a><a name="p2012mcpsimp"></a>各路图像的stride不要求相等，要求16对齐。</p>
</td>
</tr>
<tr id="row2013mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p2015mcpsimp"><a name="p2015mcpsimp"></a><a name="p2015mcpsimp"></a>像素格式</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p2017mcpsimp"><a name="p2017mcpsimp"></a><a name="p2017mcpsimp"></a>各路图像相同，仅支持OT_PIXEL_FORMAT_YVU_SEMIPLANAR_420。</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2019mcpsimp"><a name="p2019mcpsimp"></a><a name="p2019mcpsimp"></a>各路图像相同，支持OT_PIXEL_FORMAT_YVU_SEMIPLANAR_420，OT_PIXEL_FORMAT_YVU_SEMIPLANAR_422或单分量。</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2021mcpsimp"><a name="p2021mcpsimp"></a><a name="p2021mcpsimp"></a>各路图像相同，支持OT_PIXEL_FORMAT_YVU_SEMIPLANAR_420，OT_PIXEL_FORMAT_YVU_SEMIPLANAR_422或单分量。</p>
</td>
</tr>
<tr id="row2022mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p2024mcpsimp"><a name="p2024mcpsimp"></a><a name="p2024mcpsimp"></a>视频格式</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p2026mcpsimp"><a name="p2026mcpsimp"></a><a name="p2026mcpsimp"></a>各路图像相同，仅支持TILE_16x8</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2028mcpsimp"><a name="p2028mcpsimp"></a><a name="p2028mcpsimp"></a>各路图像相同，仅支持LINEAR</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2030mcpsimp"><a name="p2030mcpsimp"></a><a name="p2030mcpsimp"></a>各路图像相同，仅支持LINEAR</p>
</td>
</tr>
<tr id="row2031mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p2033mcpsimp"><a name="p2033mcpsimp"></a><a name="p2033mcpsimp"></a>压缩模式</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p2035mcpsimp"><a name="p2035mcpsimp"></a><a name="p2035mcpsimp"></a>支持TILE压缩或者非压格式，各路图像的压缩模式要求相同。</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2037mcpsimp"><a name="p2037mcpsimp"></a><a name="p2037mcpsimp"></a>支持非压或者SEG或SEG_COMPACT压缩模式。各路图像要求相同。</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2039mcpsimp"><a name="p2039mcpsimp"></a><a name="p2039mcpsimp"></a>支持非压或者SEG压缩模式。在非压缩输出时还支持输入SEG_COMPACT压缩模式。各路图像要求相同</p>
</td>
</tr>
<tr id="row2040mcpsimp"><td class="cellrowborder" valign="top" width="11.201120112011202%" headers="mcps1.2.5.1.1 mcps1.2.5.2.1 "><p id="p2042mcpsimp"><a name="p2042mcpsimp"></a><a name="p2042mcpsimp"></a>动态范围</p>
</td>
<td class="cellrowborder" valign="top" width="30.213021302130212%" headers="mcps1.2.5.1.2 mcps1.2.5.2.2 "><p id="p2044mcpsimp"><a name="p2044mcpsimp"></a><a name="p2044mcpsimp"></a>各路图像的动态范围相同。</p>
</td>
<td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.2.5.1.2 mcps1.2.5.2.3 "><p id="p2046mcpsimp"><a name="p2046mcpsimp"></a><a name="p2046mcpsimp"></a>各路图像的动态范围相同。</p>
</td>
<td class="cellrowborder" valign="top" width="28.28282828282828%" headers="mcps1.2.5.1.2 "><p id="p2048mcpsimp"><a name="p2048mcpsimp"></a><a name="p2048mcpsimp"></a>各路图像的动态范围相同。</p>
</td>
</tr>
</tbody>
</table>

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_destroy\_grp<a name="ZH-CN_TOPIC_0000002408098278"></a>

【描述】

销毁一个AVS GROUP。

【语法】

```
td_s32 ss_mpi_avs_destroy_grp(ot_avs_grp grp);
```

【参数】

<a name="table2061mcpsimp"></a>
<table><thead align="left"><tr id="row2067mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2069mcpsimp"><a name="p2069mcpsimp"></a><a name="p2069mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2071mcpsimp"><a name="p2071mcpsimp"></a><a name="p2071mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2073mcpsimp"><a name="p2073mcpsimp"></a><a name="p2073mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2075mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2077mcpsimp"><a name="p2077mcpsimp"></a><a name="p2077mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2079mcpsimp"><a name="p2079mcpsimp"></a><a name="p2079mcpsimp"></a>AVS GROUP号。</p>
<p id="p2080mcpsimp"><a name="p2080mcpsimp"></a><a name="p2080mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2083mcpsimp"><a name="p2083mcpsimp"></a><a name="p2083mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2085mcpsimp"></a>
<table><thead align="left"><tr id="row2090mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2092mcpsimp"><a name="p2092mcpsimp"></a><a name="p2092mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2094mcpsimp"><a name="p2094mcpsimp"></a><a name="p2094mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2096mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2098mcpsimp"><a name="p2098mcpsimp"></a><a name="p2098mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2100mcpsimp"><a name="p2100mcpsimp"></a><a name="p2100mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2101mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2103mcpsimp"><a name="p2103mcpsimp"></a><a name="p2103mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2105mcpsimp"><a name="p2105mcpsimp"></a><a name="p2105mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   组必须已经创建。
-   调用此接口之前，必须先调用[ss\_mpi\_avs\_stop\_grp](ss_mpi_avs_stop_grp.md)禁用此GROUP。
-   调用此接口时，会一直等待此GROUP当前任务处理结束才会真正销毁。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_start\_grp<a name="ZH-CN_TOPIC_0000002408098186"></a>

【描述】

启用AVS GROUP。

【语法】

```
td_s32 ss_mpi_avs_start_grp(ot_avs_grp grp);
```

【参数】

<a name="table2130mcpsimp"></a>
<table><thead align="left"><tr id="row2136mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2138mcpsimp"><a name="p2138mcpsimp"></a><a name="p2138mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2140mcpsimp"><a name="p2140mcpsimp"></a><a name="p2140mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2142mcpsimp"><a name="p2142mcpsimp"></a><a name="p2142mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2144mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2146mcpsimp"><a name="p2146mcpsimp"></a><a name="p2146mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2148mcpsimp"><a name="p2148mcpsimp"></a><a name="p2148mcpsimp"></a>AVS GROUP号。</p>
<p id="p2149mcpsimp"><a name="p2149mcpsimp"></a><a name="p2149mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2152mcpsimp"><a name="p2152mcpsimp"></a><a name="p2152mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2154mcpsimp"></a>
<table><thead align="left"><tr id="row2159mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2161mcpsimp"><a name="p2161mcpsimp"></a><a name="p2161mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2163mcpsimp"><a name="p2163mcpsimp"></a><a name="p2163mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2165mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2167mcpsimp"><a name="p2167mcpsimp"></a><a name="p2167mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2169mcpsimp"><a name="p2169mcpsimp"></a><a name="p2169mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2170mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2172mcpsimp"><a name="p2172mcpsimp"></a><a name="p2172mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2174mcpsimp"><a name="p2174mcpsimp"></a><a name="p2174mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   组必须已经创建。
-   重复调用该函数启用同一个组返回成功。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_stop\_grp<a name="ZH-CN_TOPIC_0000002408098262"></a>

【描述】

禁用AVS GROUP。

【语法】

```
td_s32 ss_mpi_avs_stop_grp(ot_avs_grp grp);
```

【参数】

<a name="table2197mcpsimp"></a>
<table><thead align="left"><tr id="row2203mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2205mcpsimp"><a name="p2205mcpsimp"></a><a name="p2205mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2207mcpsimp"><a name="p2207mcpsimp"></a><a name="p2207mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2209mcpsimp"><a name="p2209mcpsimp"></a><a name="p2209mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2211mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2213mcpsimp"><a name="p2213mcpsimp"></a><a name="p2213mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2215mcpsimp"><a name="p2215mcpsimp"></a><a name="p2215mcpsimp"></a>AVS GROUP号。</p>
<p id="p2216mcpsimp"><a name="p2216mcpsimp"></a><a name="p2216mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2219mcpsimp"><a name="p2219mcpsimp"></a><a name="p2219mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2221mcpsimp"></a>
<table><thead align="left"><tr id="row2226mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2228mcpsimp"><a name="p2228mcpsimp"></a><a name="p2228mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2230mcpsimp"><a name="p2230mcpsimp"></a><a name="p2230mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2232mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2234mcpsimp"><a name="p2234mcpsimp"></a><a name="p2234mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2236mcpsimp"><a name="p2236mcpsimp"></a><a name="p2236mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2237mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2239mcpsimp"><a name="p2239mcpsimp"></a><a name="p2239mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2241mcpsimp"><a name="p2241mcpsimp"></a><a name="p2241mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   组必须已经创建。
-   重复调用该函数禁用同一个组返回成功。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_start\_grp](#ss_mpi_avs_start_grp)

### ss\_mpi\_avs\_reset\_grp<a name="ZH-CN_TOPIC_0000002408258106"></a>

【描述】

重置AVS GROUP。

【语法】

```
td_s32 ss_mpi_avs_reset_grp(ot_avs_grp grp);
```

【参数】

<a name="table2265mcpsimp"></a>
<table><thead align="left"><tr id="row2271mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2273mcpsimp"><a name="p2273mcpsimp"></a><a name="p2273mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2275mcpsimp"><a name="p2275mcpsimp"></a><a name="p2275mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2277mcpsimp"><a name="p2277mcpsimp"></a><a name="p2277mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2279mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2281mcpsimp"><a name="p2281mcpsimp"></a><a name="p2281mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2283mcpsimp"><a name="p2283mcpsimp"></a><a name="p2283mcpsimp"></a>AVS GROUP号。</p>
<p id="p2284mcpsimp"><a name="p2284mcpsimp"></a><a name="p2284mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2287mcpsimp"><a name="p2287mcpsimp"></a><a name="p2287mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2289mcpsimp"></a>
<table><thead align="left"><tr id="row2294mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2296mcpsimp"><a name="p2296mcpsimp"></a><a name="p2296mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2298mcpsimp"><a name="p2298mcpsimp"></a><a name="p2298mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2300mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2302mcpsimp"><a name="p2302mcpsimp"></a><a name="p2302mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2304mcpsimp"><a name="p2304mcpsimp"></a><a name="p2304mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2305mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2307mcpsimp"><a name="p2307mcpsimp"></a><a name="p2307mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2309mcpsimp"><a name="p2309mcpsimp"></a><a name="p2309mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

组必须已经创建。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_start\_grp](#ss_mpi_avs_start_grp)

### ss\_mpi\_avs\_close\_fd<a name="ZH-CN_TOPIC_0000002408098174"></a>

【描述】

关闭组和通道的文件描述符。

【语法】

```
td_s32 ss_mpi_avs_close_fd(td_void);
```

【参数】

无。

【返回值】

<a name="table2331mcpsimp"></a>
<table><thead align="left"><tr id="row2336mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2338mcpsimp"><a name="p2338mcpsimp"></a><a name="p2338mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2340mcpsimp"><a name="p2340mcpsimp"></a><a name="p2340mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2342mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2344mcpsimp"><a name="p2344mcpsimp"></a><a name="p2344mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2346mcpsimp"><a name="p2346mcpsimp"></a><a name="p2346mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2347mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2349mcpsimp"><a name="p2349mcpsimp"></a><a name="p2349mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2351mcpsimp"><a name="p2351mcpsimp"></a><a name="p2351mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

该接口不能与其它的AVS接口同时调用，用户须保证该接口与其他接口在时间上是串行调用的。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_get\_grp\_attr<a name="ZH-CN_TOPIC_0000002441657633"></a>

【描述】

获取AVS GROUP属性。

【语法】

```
td_s32 ss_mpi_avs_get_grp_attr(ot_avs_grp grp,ot_avs_grp_attr *grp_attr);
```

【参数】

<a name="table2373mcpsimp"></a>
<table><thead align="left"><tr id="row2379mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2381mcpsimp"><a name="p2381mcpsimp"></a><a name="p2381mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2383mcpsimp"><a name="p2383mcpsimp"></a><a name="p2383mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2385mcpsimp"><a name="p2385mcpsimp"></a><a name="p2385mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2387mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2389mcpsimp"><a name="p2389mcpsimp"></a><a name="p2389mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2391mcpsimp"><a name="p2391mcpsimp"></a><a name="p2391mcpsimp"></a>AVS GROUP号。</p>
<p id="p2392mcpsimp"><a name="p2392mcpsimp"></a><a name="p2392mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2395mcpsimp"><a name="p2395mcpsimp"></a><a name="p2395mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2396mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2398mcpsimp"><a name="p2398mcpsimp"></a><a name="p2398mcpsimp"></a>grp_attr</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2400mcpsimp"><a name="p2400mcpsimp"></a><a name="p2400mcpsimp"></a>AVS GROUP属性指针。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2402mcpsimp"><a name="p2402mcpsimp"></a><a name="p2402mcpsimp"></a>输出</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2404mcpsimp"></a>
<table><thead align="left"><tr id="row2409mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2411mcpsimp"><a name="p2411mcpsimp"></a><a name="p2411mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2413mcpsimp"><a name="p2413mcpsimp"></a><a name="p2413mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2415mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2417mcpsimp"><a name="p2417mcpsimp"></a><a name="p2417mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2419mcpsimp"><a name="p2419mcpsimp"></a><a name="p2419mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2420mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2422mcpsimp"><a name="p2422mcpsimp"></a><a name="p2422mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2424mcpsimp"><a name="p2424mcpsimp"></a><a name="p2424mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

组必须已经创建。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_create\_grp](#ss_mpi_avs_create_grp)

### ss\_mpi\_avs\_set\_grp\_attr<a name="ZH-CN_TOPIC_0000002441657537"></a>

【描述】

设置AVS GROUP属性。

【语法】

```
td_s32 ss_mpi_avs_set_grp_attr(ot_avs_grp grp, const ot_avs_grp_attr *grp_attr);
```

【参数】

<a name="table2447mcpsimp"></a>
<table><thead align="left"><tr id="row2453mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2455mcpsimp"><a name="p2455mcpsimp"></a><a name="p2455mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2457mcpsimp"><a name="p2457mcpsimp"></a><a name="p2457mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2459mcpsimp"><a name="p2459mcpsimp"></a><a name="p2459mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2461mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2463mcpsimp"><a name="p2463mcpsimp"></a><a name="p2463mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2465mcpsimp"><a name="p2465mcpsimp"></a><a name="p2465mcpsimp"></a>AVS GROUP号。</p>
<p id="p2466mcpsimp"><a name="p2466mcpsimp"></a><a name="p2466mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2469mcpsimp"><a name="p2469mcpsimp"></a><a name="p2469mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2470mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2472mcpsimp"><a name="p2472mcpsimp"></a><a name="p2472mcpsimp"></a>grp_attr</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2474mcpsimp"><a name="p2474mcpsimp"></a><a name="p2474mcpsimp"></a>AVS GROUP属性指针。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2476mcpsimp"><a name="p2476mcpsimp"></a><a name="p2476mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2478mcpsimp"></a>
<table><thead align="left"><tr id="row2483mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2485mcpsimp"><a name="p2485mcpsimp"></a><a name="p2485mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2487mcpsimp"><a name="p2487mcpsimp"></a><a name="p2487mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2489mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2491mcpsimp"><a name="p2491mcpsimp"></a><a name="p2491mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2493mcpsimp"><a name="p2493mcpsimp"></a><a name="p2493mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2494mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2496mcpsimp"><a name="p2496mcpsimp"></a><a name="p2496mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2498mcpsimp"><a name="p2498mcpsimp"></a><a name="p2498mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   组必须已经创建。
-   GROUP属性必须合法，其中部分静态属性不可动态设置，具体请参见[ot\_avs\_grp\_attr](ot_avs_grp_attr.md)。
-   如果使用该接口动态切换投影模式，要确保工作空间大小working\_set\_size满足目标投影模式需要的大小，否则切换不成功。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_get\_grp\_attr](#ss_mpi_avs_get_grp_attr)

### ss\_mpi\_avs\_send\_pipe\_frame<a name="ZH-CN_TOPIC_0000002441697501"></a>

【描述】

用户向AVS GROUP上的PIPE发送图像。

【语法】

```
td_s32 ss_mpi_avs_send_pipe_frame(ot_avs_grp grp, ot_avs_pipe pipe, const ot_video_frame_info *frame_info, td_s32 milli_sec);
```

【参数】

<a name="table2530mcpsimp"></a>
<table><thead align="left"><tr id="row2536mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p2538mcpsimp"><a name="p2538mcpsimp"></a><a name="p2538mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2540mcpsimp"><a name="p2540mcpsimp"></a><a name="p2540mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p2542mcpsimp"><a name="p2542mcpsimp"></a><a name="p2542mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2544mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p id="p2546mcpsimp"><a name="p2546mcpsimp"></a><a name="p2546mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2548mcpsimp"><a name="p2548mcpsimp"></a><a name="p2548mcpsimp"></a>AVS GROUP号。</p>
<p id="p2549mcpsimp"><a name="p2549mcpsimp"></a><a name="p2549mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2552mcpsimp"><a name="p2552mcpsimp"></a><a name="p2552mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2553mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2555mcpsimp"><a name="p2555mcpsimp"></a><a name="p2555mcpsimp"></a>pipe</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2557mcpsimp"><a name="p2557mcpsimp"></a><a name="p2557mcpsimp"></a>用户送入图像的管道号。取值范围为[0, <a href="OT_AVS_PIPE_NUM.md"><span xml:lang="sv-SE" id="ph2559mcpsimp"><a name="ph2559mcpsimp"></a><a name="ph2559mcpsimp"></a>OT_AVS_PIPE_NUM</span></a>)</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2561mcpsimp"><a name="p2561mcpsimp"></a><a name="p2561mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2562mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2564mcpsimp"><a name="p2564mcpsimp"></a><a name="p2564mcpsimp"></a>frame_info</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p2566mcpsimp"><a name="p2566mcpsimp"></a><a name="p2566mcpsimp"></a>待发送的图像信息。ot_video_frame_info<span xml:lang="en-US" id="ph2567mcpsimp"><a name="ph2567mcpsimp"></a><a name="ph2567mcpsimp"></a>具体描述请参见</span>“<span xml:lang="en-US" id="ph2568mcpsimp"><a name="ph2568mcpsimp"></a><a name="ph2568mcpsimp"></a>系统控制</span>”<span xml:lang="en-US" id="ph2569mcpsimp"><a name="ph2569mcpsimp"></a><a name="ph2569mcpsimp"></a>章节。</span></p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p2571mcpsimp"><a name="p2571mcpsimp"></a><a name="p2571mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2572mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2574mcpsimp"><a name="p2574mcpsimp"></a><a name="p2574mcpsimp"></a>milli_sec</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><a name="ul2576mcpsimp"></a><a name="ul2576mcpsimp"></a><ul id="ul2576mcpsimp"><li xml:lang="zh-CN">超时参数<span xml:lang="sv-SE" id="ph2578mcpsimp"><a name="ph2578mcpsimp"></a><a name="ph2578mcpsimp"></a>milli_sec</span>设为-1时，为阻塞发送；</li><li xml:lang="zh-CN">0时为非阻塞<span xml:lang="en-US" id="ph2580mcpsimp"><a name="ph2580mcpsimp"></a><a name="ph2580mcpsimp"></a>发送；</span></li><li>大于0时为超时等待发送时间，超时时间的单位为毫秒（ms）。</li></ul>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p xml:lang="sv-SE" id="p2583mcpsimp"><a name="p2583mcpsimp"></a><a name="p2583mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2585mcpsimp"></a>
<table><thead align="left"><tr id="row2590mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2592mcpsimp"><a name="p2592mcpsimp"></a><a name="p2592mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2594mcpsimp"><a name="p2594mcpsimp"></a><a name="p2594mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2596mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2598mcpsimp"><a name="p2598mcpsimp"></a><a name="p2598mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2600mcpsimp"><a name="p2600mcpsimp"></a><a name="p2600mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2601mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2603mcpsimp"><a name="p2603mcpsimp"></a><a name="p2603mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2605mcpsimp"><a name="p2605mcpsimp"></a><a name="p2605mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

组必须已经创建。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_get\_pipe\_frame<a name="ZH-CN_TOPIC_0000002441697437"></a>

【描述】

用户从AVS GROUP上的PIPE获取一帧原始图像。

【语法】

```
td_s32 ss_mpi_avs_get_pipe_frame(ot_avs_grp grp, ot_avs_pipe pipe, ot_video_frame_info *frame_info, td_s32 milli_sec);
```

【参数】

<a name="table2627mcpsimp"></a>
<table><thead align="left"><tr id="row2633mcpsimp"><th class="cellrowborder" valign="top" width="21%" id="mcps1.1.4.1.1"><p id="p2635mcpsimp"><a name="p2635mcpsimp"></a><a name="p2635mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="62%" id="mcps1.1.4.1.2"><p id="p2637mcpsimp"><a name="p2637mcpsimp"></a><a name="p2637mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="17%" id="mcps1.1.4.1.3"><p id="p2639mcpsimp"><a name="p2639mcpsimp"></a><a name="p2639mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2641mcpsimp"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2643mcpsimp"><a name="p2643mcpsimp"></a><a name="p2643mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p id="p2645mcpsimp"><a name="p2645mcpsimp"></a><a name="p2645mcpsimp"></a>AVS GROUP号。</p>
<p id="p2646mcpsimp"><a name="p2646mcpsimp"></a><a name="p2646mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.1.4.1.3 "><p id="p2649mcpsimp"><a name="p2649mcpsimp"></a><a name="p2649mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2650mcpsimp"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2652mcpsimp"><a name="p2652mcpsimp"></a><a name="p2652mcpsimp"></a>pipe</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p id="p2654mcpsimp"><a name="p2654mcpsimp"></a><a name="p2654mcpsimp"></a>用户送入图像的管道号。取值范围为[0, <a href="OT_AVS_PIPE_NUM.md"><span xml:lang="sv-SE" id="ph2656mcpsimp"><a name="ph2656mcpsimp"></a><a name="ph2656mcpsimp"></a>OT_AVS_PIPE_NUM</span></a>)</p>
</td>
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.1.4.1.3 "><p id="p2658mcpsimp"><a name="p2658mcpsimp"></a><a name="p2658mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2659mcpsimp"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2661mcpsimp"><a name="p2661mcpsimp"></a><a name="p2661mcpsimp"></a>frame_info</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p2663mcpsimp"><a name="p2663mcpsimp"></a><a name="p2663mcpsimp"></a>获取的图像信息。ot_video_frame_info<span xml:lang="en-US" id="ph2664mcpsimp"><a name="ph2664mcpsimp"></a><a name="ph2664mcpsimp"></a>具体描述请参见“系统控制”章节。</span></p>
</td>
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.1.4.1.3 "><p id="p2666mcpsimp"><a name="p2666mcpsimp"></a><a name="p2666mcpsimp"></a>输出</p>
</td>
</tr>
<tr id="row2667mcpsimp"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2669mcpsimp"><a name="p2669mcpsimp"></a><a name="p2669mcpsimp"></a>milli_sec</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><a name="ul2671mcpsimp"></a><a name="ul2671mcpsimp"></a><ul id="ul2671mcpsimp"><li xml:lang="zh-CN">超时参数<span xml:lang="sv-SE" id="ph2673mcpsimp"><a name="ph2673mcpsimp"></a><a name="ph2673mcpsimp"></a>milli_sec</span>设为-1时，为阻塞获取；</li><li xml:lang="zh-CN">0时为非阻塞<span xml:lang="en-US" id="ph2675mcpsimp"><a name="ph2675mcpsimp"></a><a name="ph2675mcpsimp"></a>获取；</span></li></ul>
<p id="p2676mcpsimp"><a name="p2676mcpsimp"></a><a name="p2676mcpsimp"></a>大于0时为超时等待获取时间，超时时间的单位为毫秒（ms）。</p>
</td>
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.1.4.1.3 "><p xml:lang="sv-SE" id="p2678mcpsimp"><a name="p2678mcpsimp"></a><a name="p2678mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2680mcpsimp"></a>
<table><thead align="left"><tr id="row2685mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2687mcpsimp"><a name="p2687mcpsimp"></a><a name="p2687mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2689mcpsimp"><a name="p2689mcpsimp"></a><a name="p2689mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2691mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2693mcpsimp"><a name="p2693mcpsimp"></a><a name="p2693mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2695mcpsimp"><a name="p2695mcpsimp"></a><a name="p2695mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2696mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2698mcpsimp"><a name="p2698mcpsimp"></a><a name="p2698mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2700mcpsimp"><a name="p2700mcpsimp"></a><a name="p2700mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   获取的图像要及时释放，否则将造成VB不够的情况，建议与[ss\_mpi\_avs\_release\_pipe\_frame](ss_mpi_avs_release_pipe_frame.md)接口配对使用。

【相关主题】

[ss\_mpi\_avs\_release\_pipe\_frame](#ss_mpi_avs_release_pipe_frame)

### ss\_mpi\_avs\_release\_pipe\_frame<a name="ZH-CN_TOPIC_0000002408258094"></a>

【描述】

用户释放一帧原始图像。

【语法】

```
td_s32 ss_mpi_avs_release_pipe_frame(ot_avs_grp grp, ot_avs_pipe pipe, const ot_video_frame_info *frame_info);
```

【参数】

<a name="table2724mcpsimp"></a>
<table><thead align="left"><tr id="row2730mcpsimp"><th class="cellrowborder" valign="top" width="19%" id="mcps1.1.4.1.1"><p id="p2732mcpsimp"><a name="p2732mcpsimp"></a><a name="p2732mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="66%" id="mcps1.1.4.1.2"><p id="p2734mcpsimp"><a name="p2734mcpsimp"></a><a name="p2734mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="15%" id="mcps1.1.4.1.3"><p id="p2736mcpsimp"><a name="p2736mcpsimp"></a><a name="p2736mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2738mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2740mcpsimp"><a name="p2740mcpsimp"></a><a name="p2740mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.1.4.1.2 "><p id="p2742mcpsimp"><a name="p2742mcpsimp"></a><a name="p2742mcpsimp"></a>AVS GROUP号。</p>
<p id="p2743mcpsimp"><a name="p2743mcpsimp"></a><a name="p2743mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.1.4.1.3 "><p id="p2746mcpsimp"><a name="p2746mcpsimp"></a><a name="p2746mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2747mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2749mcpsimp"><a name="p2749mcpsimp"></a><a name="p2749mcpsimp"></a>pipe</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.1.4.1.2 "><p id="p2751mcpsimp"><a name="p2751mcpsimp"></a><a name="p2751mcpsimp"></a>AVS PIPE号。</p>
<p xml:lang="sv-SE" id="p2752mcpsimp"><a name="p2752mcpsimp"></a><a name="p2752mcpsimp"></a><span xml:lang="en-US" id="ph2753mcpsimp"><a name="ph2753mcpsimp"></a><a name="ph2753mcpsimp"></a>取值范围[0, </span><a href="OT_AVS_PIPE_NUM.md">OT_AVS_PIPE_NUM</a><span xml:lang="en-US" id="ph2755mcpsimp"><a name="ph2755mcpsimp"></a><a name="ph2755mcpsimp"></a>)。</span></p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.1.4.1.3 "><p id="p2757mcpsimp"><a name="p2757mcpsimp"></a><a name="p2757mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2758mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p id="p2760mcpsimp"><a name="p2760mcpsimp"></a><a name="p2760mcpsimp"></a>frame_info</p>
</td>
<td class="cellrowborder" valign="top" width="66%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p2762mcpsimp"><a name="p2762mcpsimp"></a><a name="p2762mcpsimp"></a>图像信息。ot_video_frame_info<span xml:lang="en-US" id="ph2763mcpsimp"><a name="ph2763mcpsimp"></a><a name="ph2763mcpsimp"></a>具体描述请参见“系统控制”章节。</span></p>
</td>
<td class="cellrowborder" valign="top" width="15%" headers="mcps1.1.4.1.3 "><p id="p2765mcpsimp"><a name="p2765mcpsimp"></a><a name="p2765mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2767mcpsimp"></a>
<table><thead align="left"><tr id="row2772mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2774mcpsimp"><a name="p2774mcpsimp"></a><a name="p2774mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2776mcpsimp"><a name="p2776mcpsimp"></a><a name="p2776mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2778mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2780mcpsimp"><a name="p2780mcpsimp"></a><a name="p2780mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2782mcpsimp"><a name="p2782mcpsimp"></a><a name="p2782mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2783mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2785mcpsimp"><a name="p2785mcpsimp"></a><a name="p2785mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2787mcpsimp"><a name="p2787mcpsimp"></a><a name="p2787mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   实际上，此接口的grp和pipe参数并无实际用途，可在取值范围内任意设置。
-   此接口需与[ss\_mpi\_avs\_get\_pipe\_frame](ss_mpi_avs_get_pipe_frame.md)配对使用。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_get\_pipe\_frame](#ss_mpi_avs_get_pipe_frame)

### ss\_mpi\_avs\_set\_chn\_attr<a name="ZH-CN_TOPIC_0000002408258186"></a>

【描述】

设置AVS通道属性。

【语法】

```
td_s32 ss_mpi_avs_set_chn_attr(ot_avs_grp grp, ot_avs_chn chn, const ot_avs_chn_attr *chn_attr);
```

【参数】

<a name="table2817mcpsimp"></a>
<table><thead align="left"><tr id="row2823mcpsimp"><th class="cellrowborder" valign="top" width="18%" id="mcps1.1.4.1.1"><p id="p2825mcpsimp"><a name="p2825mcpsimp"></a><a name="p2825mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p2827mcpsimp"><a name="p2827mcpsimp"></a><a name="p2827mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="18%" id="mcps1.1.4.1.3"><p id="p2829mcpsimp"><a name="p2829mcpsimp"></a><a name="p2829mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2831mcpsimp"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2833mcpsimp"><a name="p2833mcpsimp"></a><a name="p2833mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2835mcpsimp"><a name="p2835mcpsimp"></a><a name="p2835mcpsimp"></a>AVS GROUP号。</p>
<p id="p2836mcpsimp"><a name="p2836mcpsimp"></a><a name="p2836mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.3 "><p id="p2839mcpsimp"><a name="p2839mcpsimp"></a><a name="p2839mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2840mcpsimp"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2842mcpsimp"><a name="p2842mcpsimp"></a><a name="p2842mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p2844mcpsimp"><a name="p2844mcpsimp"></a><a name="p2844mcpsimp"></a><span xml:lang="sv-SE" id="ph2845mcpsimp"><a name="ph2845mcpsimp"></a><a name="ph2845mcpsimp"></a>AVS </span>通道号。</p>
<p xml:lang="sv-SE" id="p2846mcpsimp"><a name="p2846mcpsimp"></a><a name="p2846mcpsimp"></a><a href="ot_avs_mode.md#OT_AVS_MODE_BLEND">OT_AVS_MODE_BLEND</a><span xml:lang="en-US" id="ph2848mcpsimp"><a name="ph2848mcpsimp"></a><a name="ph2848mcpsimp"></a>模式下</span>，<span xml:lang="en-US" id="ph2849mcpsimp"><a name="ph2849mcpsimp"></a><a name="ph2849mcpsimp"></a>取值范围</span>[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)</p>
<p xml:lang="sv-SE" id="p2851mcpsimp"><a name="p2851mcpsimp"></a><a name="p2851mcpsimp"></a><a href="ot_avs_mode.md#OT_AVS_MODE_NOBLEND_VER">OT_AVS_MODE_NOBLEND_VER</a>、<a href="ot_avs_mode.md#OT_AVS_MODE_NOBLEND_HOR">OT_AVS_MODE_NOBLEND_HOR</a>和<a href="ot_avs_mode.md#OT_AVS_MODE_NOBLEND_QR">OT_AVS_MODE_NOBLEND_QR</a><span xml:lang="en-US" id="ph2855mcpsimp"><a name="ph2855mcpsimp"></a><a name="ph2855mcpsimp"></a>模式下只能取</span>0<span xml:lang="en-US" id="ph2856mcpsimp"><a name="ph2856mcpsimp"></a><a name="ph2856mcpsimp"></a>。</span></p>
<p xml:lang="sv-SE" id="p2857mcpsimp"><a name="p2857mcpsimp"></a><a name="p2857mcpsimp"></a><span xml:lang="en-US" id="ph2858mcpsimp"><a name="ph2858mcpsimp"></a><a name="ph2858mcpsimp"></a>在</span><a href="ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP">OT_AVS_PROJECTION_CUBE_MAP</a><span xml:lang="en-US" id="ph2860mcpsimp"><a name="ph2860mcpsimp"></a><a name="ph2860mcpsimp"></a>投影模式下</span>，<span xml:lang="en-US" id="ph2861mcpsimp"><a name="ph2861mcpsimp"></a><a name="ph2861mcpsimp"></a>只能取</span>0<span xml:lang="en-US" id="ph2862mcpsimp"><a name="ph2862mcpsimp"></a><a name="ph2862mcpsimp"></a>。</span></p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.3 "><p id="p2864mcpsimp"><a name="p2864mcpsimp"></a><a name="p2864mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2865mcpsimp"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2867mcpsimp"><a name="p2867mcpsimp"></a><a name="p2867mcpsimp"></a>chn_attr</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p2869mcpsimp"><a name="p2869mcpsimp"></a><a name="p2869mcpsimp"></a>AVS通道属性结构体指针。</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.1.4.1.3 "><p id="p2871mcpsimp"><a name="p2871mcpsimp"></a><a name="p2871mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2873mcpsimp"></a>
<table><thead align="left"><tr id="row2878mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2880mcpsimp"><a name="p2880mcpsimp"></a><a name="p2880mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2882mcpsimp"><a name="p2882mcpsimp"></a><a name="p2882mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2884mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2886mcpsimp"><a name="p2886mcpsimp"></a><a name="p2886mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2888mcpsimp"><a name="p2888mcpsimp"></a><a name="p2888mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2889mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2891mcpsimp"><a name="p2891mcpsimp"></a><a name="p2891mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2893mcpsimp"><a name="p2893mcpsimp"></a><a name="p2893mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   必须要先设置通道0的属性，才能设置其他通道的属性。
-   [OT\_AVS\_MODE\_NOBLEND\_VER](ot_avs_mode.md#OT_AVS_MODE_NOBLEND_VER)、[OT\_AVS\_MODE\_NOBLEND\_HOR](ot_avs_mode.md#OT_AVS_MODE_NOBLEND_HOR)和[OT\_AVS\_MODE\_NOBLEND\_QR](ot_avs_mode.md#OT_AVS_MODE_NOBLEND_QR)模式下，只能设置0通道的属性。
-   在[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)投影模式下，只能设置0通道的属性。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_get\_chn\_attr](#ss_mpi_avs_get_chn_attr)

### ss\_mpi\_avs\_get\_chn\_attr<a name="ZH-CN_TOPIC_0000002441697349"></a>

【描述】

获取AVS通道属性。

【语法】

```
td_s32 ss_mpi_avs_get_chn_attr(ot_avs_grp grp, ot_avs_chn chn, ot_avs_chn_attr *chn_attr);
```

【参数】

<a name="table2929mcpsimp"></a>
<table><thead align="left"><tr id="row2935mcpsimp"><th class="cellrowborder" valign="top" width="19%" id="mcps1.1.4.1.1"><p id="p2937mcpsimp"><a name="p2937mcpsimp"></a><a name="p2937mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="62%" id="mcps1.1.4.1.2"><p id="p2939mcpsimp"><a name="p2939mcpsimp"></a><a name="p2939mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="19%" id="mcps1.1.4.1.3"><p id="p2941mcpsimp"><a name="p2941mcpsimp"></a><a name="p2941mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row2943mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2945mcpsimp"><a name="p2945mcpsimp"></a><a name="p2945mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p id="p2947mcpsimp"><a name="p2947mcpsimp"></a><a name="p2947mcpsimp"></a>AVS GROUP号。</p>
<p id="p2948mcpsimp"><a name="p2948mcpsimp"></a><a name="p2948mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.3 "><p id="p2951mcpsimp"><a name="p2951mcpsimp"></a><a name="p2951mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2952mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2954mcpsimp"><a name="p2954mcpsimp"></a><a name="p2954mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p id="p2956mcpsimp"><a name="p2956mcpsimp"></a><a name="p2956mcpsimp"></a>AVS 通道号。</p>
<p id="p2957mcpsimp"><a name="p2957mcpsimp"></a><a name="p2957mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.3 "><p id="p2960mcpsimp"><a name="p2960mcpsimp"></a><a name="p2960mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row2961mcpsimp"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p2963mcpsimp"><a name="p2963mcpsimp"></a><a name="p2963mcpsimp"></a>chn_attr</p>
</td>
<td class="cellrowborder" valign="top" width="62%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p2965mcpsimp"><a name="p2965mcpsimp"></a><a name="p2965mcpsimp"></a>AVS通道属性结构体指针。</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.3 "><p id="p2967mcpsimp"><a name="p2967mcpsimp"></a><a name="p2967mcpsimp"></a>输出</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table2969mcpsimp"></a>
<table><thead align="left"><tr id="row2974mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p2976mcpsimp"><a name="p2976mcpsimp"></a><a name="p2976mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p2978mcpsimp"><a name="p2978mcpsimp"></a><a name="p2978mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row2980mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2982mcpsimp"><a name="p2982mcpsimp"></a><a name="p2982mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2984mcpsimp"><a name="p2984mcpsimp"></a><a name="p2984mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row2985mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p2987mcpsimp"><a name="p2987mcpsimp"></a><a name="p2987mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p2989mcpsimp"><a name="p2989mcpsimp"></a><a name="p2989mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   如果没有设置通道属性就获取，获取的值为0。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_set\_chn\_attr](#ss_mpi_avs_set_chn_attr)

### ss\_mpi\_avs\_enable\_chn<a name="ZH-CN_TOPIC_0000002441697357"></a>

【描述】

启用AVS通道。

【语法】

```
td_s32 ss_mpi_avs_enable_chn(ot_avs_grp grp, ot_avs_chn chn);
```

【参数】

<a name="table111mcpsimp"></a>
<table><thead align="left"><tr id="row117mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p119mcpsimp"><a name="p119mcpsimp"></a><a name="p119mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p121mcpsimp"><a name="p121mcpsimp"></a><a name="p121mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p123mcpsimp"><a name="p123mcpsimp"></a><a name="p123mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row125mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p127mcpsimp"><a name="p127mcpsimp"></a><a name="p127mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p129mcpsimp"><a name="p129mcpsimp"></a><a name="p129mcpsimp"></a>AVS GROUP号。</p>
<p id="p130mcpsimp"><a name="p130mcpsimp"></a><a name="p130mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p133mcpsimp"><a name="p133mcpsimp"></a><a name="p133mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row134mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p136mcpsimp"><a name="p136mcpsimp"></a><a name="p136mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p138mcpsimp"><a name="p138mcpsimp"></a><a name="p138mcpsimp"></a>AVS 通道号。</p>
<p id="p139mcpsimp"><a name="p139mcpsimp"></a><a name="p139mcpsimp"></a>取值范围[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p142mcpsimp"><a name="p142mcpsimp"></a><a name="p142mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table144mcpsimp"></a>
<table><thead align="left"><tr id="row149mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p151mcpsimp"><a name="p151mcpsimp"></a><a name="p151mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p153mcpsimp"><a name="p153mcpsimp"></a><a name="p153mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row155mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p157mcpsimp"><a name="p157mcpsimp"></a><a name="p157mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p159mcpsimp"><a name="p159mcpsimp"></a><a name="p159mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row160mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p162mcpsimp"><a name="p162mcpsimp"></a><a name="p162mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p164mcpsimp"><a name="p164mcpsimp"></a><a name="p164mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   必须先使用[ss\_mpi\_avs\_set\_chn\_attr](ss_mpi_avs_set_chn_attr.md)接口设置通道属性才能启用通道。
-   通道0启用后才能启用其他的通道。
-   在[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)投影模式下，只能使能0通道。
-   多次启用通道返回成功。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_disable\_chn<a name="ZH-CN_TOPIC_0000002408098246"></a>

【描述】

禁用AVS通道

【语法】

```
td_s32 ss_mpi_avs_disable_chn(ot_avs_grp grp, ot_avs_chn chn);
```

【参数】

<a name="table198mcpsimp"></a>
<table><thead align="left"><tr id="row204mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.1.4.1.1"><p id="p206mcpsimp"><a name="p206mcpsimp"></a><a name="p206mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.4.1.2"><p id="p208mcpsimp"><a name="p208mcpsimp"></a><a name="p208mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16%" id="mcps1.1.4.1.3"><p id="p210mcpsimp"><a name="p210mcpsimp"></a><a name="p210mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row212mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p214mcpsimp"><a name="p214mcpsimp"></a><a name="p214mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p216mcpsimp"><a name="p216mcpsimp"></a><a name="p216mcpsimp"></a>AVS GROUP号。</p>
<p id="p217mcpsimp"><a name="p217mcpsimp"></a><a name="p217mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p220mcpsimp"><a name="p220mcpsimp"></a><a name="p220mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row221mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p223mcpsimp"><a name="p223mcpsimp"></a><a name="p223mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.4.1.2 "><p id="p225mcpsimp"><a name="p225mcpsimp"></a><a name="p225mcpsimp"></a>AVS 通道号。</p>
<p id="p226mcpsimp"><a name="p226mcpsimp"></a><a name="p226mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.1.4.1.3 "><p id="p229mcpsimp"><a name="p229mcpsimp"></a><a name="p229mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table231mcpsimp"></a>
<table><thead align="left"><tr id="row236mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p238mcpsimp"><a name="p238mcpsimp"></a><a name="p238mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p240mcpsimp"><a name="p240mcpsimp"></a><a name="p240mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row242mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p244mcpsimp"><a name="p244mcpsimp"></a><a name="p244mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p246mcpsimp"><a name="p246mcpsimp"></a><a name="p246mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row247mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p249mcpsimp"><a name="p249mcpsimp"></a><a name="p249mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p251mcpsimp"><a name="p251mcpsimp"></a><a name="p251mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   通道0要在其他的通道都禁用了之后才能禁用。
-   重复禁用通道返回成功。

【举例】

无。

【相关主题】

无。

### ss\_mpi\_avs\_get\_chn\_frame<a name="ZH-CN_TOPIC_0000002408258118"></a>

【描述】

用户获取一帧通道图像

【语法】

```
td_s32 ss_mpi_avs_get_chn_frame(ot_avs_grp grp, ot_avs_chn chn, ot_video_frame_info *frame_info, td_s32 milli_sec);
```

【参数】

<a name="table277mcpsimp"></a>
<table><thead align="left"><tr id="row283mcpsimp"><th class="cellrowborder" valign="top" width="23%" id="mcps1.1.4.1.1"><p id="p285mcpsimp"><a name="p285mcpsimp"></a><a name="p285mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="63%" id="mcps1.1.4.1.2"><p id="p287mcpsimp"><a name="p287mcpsimp"></a><a name="p287mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.1.4.1.3"><p id="p289mcpsimp"><a name="p289mcpsimp"></a><a name="p289mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row291mcpsimp"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p293mcpsimp"><a name="p293mcpsimp"></a><a name="p293mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.1.4.1.2 "><p id="p295mcpsimp"><a name="p295mcpsimp"></a><a name="p295mcpsimp"></a>AVS GROUP号。</p>
<p id="p296mcpsimp"><a name="p296mcpsimp"></a><a name="p296mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.1.4.1.3 "><p id="p299mcpsimp"><a name="p299mcpsimp"></a><a name="p299mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row300mcpsimp"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p302mcpsimp"><a name="p302mcpsimp"></a><a name="p302mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.1.4.1.2 "><p id="p304mcpsimp"><a name="p304mcpsimp"></a><a name="p304mcpsimp"></a>AVS 通道号。</p>
<p id="p305mcpsimp"><a name="p305mcpsimp"></a><a name="p305mcpsimp"></a>取值范围[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.1.4.1.3 "><p id="p308mcpsimp"><a name="p308mcpsimp"></a><a name="p308mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row309mcpsimp"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p311mcpsimp"><a name="p311mcpsimp"></a><a name="p311mcpsimp"></a>frame_info</p>
</td>
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="p313mcpsimp"><a name="p313mcpsimp"></a><a name="p313mcpsimp"></a>获取的图像信息。ot_video_frame_info<span xml:lang="en-US" id="ph314mcpsimp"><a name="ph314mcpsimp"></a><a name="ph314mcpsimp"></a>具体描述请参见“系统控制”章节。</span></p>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.1.4.1.3 "><p id="p316mcpsimp"><a name="p316mcpsimp"></a><a name="p316mcpsimp"></a>输出</p>
</td>
</tr>
<tr id="row317mcpsimp"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p319mcpsimp"><a name="p319mcpsimp"></a><a name="p319mcpsimp"></a>milli_sec</p>
</td>
<td class="cellrowborder" valign="top" width="63%" headers="mcps1.1.4.1.2 "><a name="ul321mcpsimp"></a><a name="ul321mcpsimp"></a><ul id="ul321mcpsimp"><li xml:lang="zh-CN">超时参数<span xml:lang="en-US" id="ph323mcpsimp"><a name="ph323mcpsimp"></a><a name="ph323mcpsimp"></a>milli_sec</span>设为-1时，为阻塞获取；</li><li xml:lang="zh-CN">0时为非阻塞<span xml:lang="en-US" id="ph325mcpsimp"><a name="ph325mcpsimp"></a><a name="ph325mcpsimp"></a>获取；</span></li><li>大于0时为超时等待获取时间，超时时间的单位为毫秒（ms）。</li></ul>
</td>
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.1.4.1.3 "><p xml:lang="sv-SE" id="p328mcpsimp"><a name="p328mcpsimp"></a><a name="p328mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table330mcpsimp"></a>
<table><thead align="left"><tr id="row335mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p337mcpsimp"><a name="p337mcpsimp"></a><a name="p337mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p339mcpsimp"><a name="p339mcpsimp"></a><a name="p339mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row341mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p343mcpsimp"><a name="p343mcpsimp"></a><a name="p343mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p345mcpsimp"><a name="p345mcpsimp"></a><a name="p345mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row346mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p348mcpsimp"><a name="p348mcpsimp"></a><a name="p348mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p350mcpsimp"><a name="p350mcpsimp"></a><a name="p350mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   GROUP必须已创建。
-   只有设置通道队列深度不为0，才能获取到图像。
-   获取的图像要及时释放，否则将造成VB不够的情况，建议与[ss\_mpi\_avs\_release\_chn\_frame](ss_mpi_avs_release_chn_frame.md)接口配对使用。

【相关主题】

[ss\_mpi\_avs\_release\_chn\_frame](#ss_mpi_avs_release_chn_frame)

### ss\_mpi\_avs\_release\_chn\_frame<a name="ZH-CN_TOPIC_0000002408098298"></a>

【描述】

用户释放一帧通道图像。

【语法】

```
td_s32 ss_mpi_avs_release_chn_frame(ot_avs_grp grp, ot_avs_chn chn, const ot_video_frame_info *frame_info);
```

【参数】

<a name="table377mcpsimp"></a>
<table><thead align="left"><tr id="row383mcpsimp"><th class="cellrowborder" valign="top" width="17.17%" id="mcps1.1.4.1.1"><p id="p385mcpsimp"><a name="p385mcpsimp"></a><a name="p385mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="66.67%" id="mcps1.1.4.1.2"><p id="p387mcpsimp"><a name="p387mcpsimp"></a><a name="p387mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="16.160000000000004%" id="mcps1.1.4.1.3"><p id="p389mcpsimp"><a name="p389mcpsimp"></a><a name="p389mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row391mcpsimp"><td class="cellrowborder" valign="top" width="17.17%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p393mcpsimp"><a name="p393mcpsimp"></a><a name="p393mcpsimp"></a>grp</p>
</td>
<td class="cellrowborder" valign="top" width="66.67%" headers="mcps1.1.4.1.2 "><p id="p395mcpsimp"><a name="p395mcpsimp"></a><a name="p395mcpsimp"></a>AVS GROUP号。</p>
<p id="p396mcpsimp"><a name="p396mcpsimp"></a><a name="p396mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_GRP_NUM.md">OT_AVS_MAX_GRP_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16.160000000000004%" headers="mcps1.1.4.1.3 "><p id="p399mcpsimp"><a name="p399mcpsimp"></a><a name="p399mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row400mcpsimp"><td class="cellrowborder" valign="top" width="17.17%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p402mcpsimp"><a name="p402mcpsimp"></a><a name="p402mcpsimp"></a>chn</p>
</td>
<td class="cellrowborder" valign="top" width="66.67%" headers="mcps1.1.4.1.2 "><p id="p404mcpsimp"><a name="p404mcpsimp"></a><a name="p404mcpsimp"></a>AVS 通道号。</p>
<p id="p405mcpsimp"><a name="p405mcpsimp"></a><a name="p405mcpsimp"></a>取值范围：[0, <a href="OT_AVS_MAX_CHN_NUM.md">OT_AVS_MAX_CHN_NUM</a>)。</p>
</td>
<td class="cellrowborder" valign="top" width="16.160000000000004%" headers="mcps1.1.4.1.3 "><p id="p408mcpsimp"><a name="p408mcpsimp"></a><a name="p408mcpsimp"></a>输入</p>
</td>
</tr>
<tr id="row409mcpsimp"><td class="cellrowborder" valign="top" width="17.17%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p411mcpsimp"><a name="p411mcpsimp"></a><a name="p411mcpsimp"></a>frame_info</p>
</td>
<td class="cellrowborder" valign="top" width="66.67%" headers="mcps1.1.4.1.2 "><p xml:lang="sv-SE" id="ot_video_frame_info"><a name="ot_video_frame_info"></a><a name="ot_video_frame_info"></a>图像信息。ot_video_frame_info<span xml:lang="en-US" id="ph413mcpsimp"><a name="ph413mcpsimp"></a><a name="ph413mcpsimp"></a>具体描述请参见“系统控制”章节。</span></p>
</td>
<td class="cellrowborder" valign="top" width="16.160000000000004%" headers="mcps1.1.4.1.3 "><p id="p415mcpsimp"><a name="p415mcpsimp"></a><a name="p415mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table417mcpsimp"></a>
<table><thead align="left"><tr id="row422mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p424mcpsimp"><a name="p424mcpsimp"></a><a name="p424mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p426mcpsimp"><a name="p426mcpsimp"></a><a name="p426mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row428mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p430mcpsimp"><a name="p430mcpsimp"></a><a name="p430mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p432mcpsimp"><a name="p432mcpsimp"></a><a name="p432mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row433mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p435mcpsimp"><a name="p435mcpsimp"></a><a name="p435mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p437mcpsimp"><a name="p437mcpsimp"></a><a name="p437mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   实际上，此接口的grp和chn参数并无实际用途，可在取值范围内任意设置。
-   此接口需与[ss\_mpi\_avs\_get\_chn\_frame](ss_mpi_avs_get_chn_frame.md)配对使用。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_get\_chn\_frame](#ss_mpi_avs_get_chn_frame)

### ss\_mpi\_avs\_get\_mod\_param<a name="ZH-CN_TOPIC_0000002408258202"></a>

【描述】

获取AVS模块参数。

【语法】

```
td_s32 ss_mpi_avs_get_mod_param(ot_avs_mod_param *mod_param);
```

【参数】

<a name="table464mcpsimp"></a>
<table><thead align="left"><tr id="row470mcpsimp"><th class="cellrowborder" valign="top" width="21.21%" id="mcps1.1.4.1.1"><p id="p472mcpsimp"><a name="p472mcpsimp"></a><a name="p472mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="56.57%" id="mcps1.1.4.1.2"><p id="p474mcpsimp"><a name="p474mcpsimp"></a><a name="p474mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="22.220000000000002%" id="mcps1.1.4.1.3"><p id="p476mcpsimp"><a name="p476mcpsimp"></a><a name="p476mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row478mcpsimp"><td class="cellrowborder" valign="top" width="21.21%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p480mcpsimp"><a name="p480mcpsimp"></a><a name="p480mcpsimp"></a>mod_param</p>
</td>
<td class="cellrowborder" valign="top" width="56.57%" headers="mcps1.1.4.1.2 "><p id="p482mcpsimp"><a name="p482mcpsimp"></a><a name="p482mcpsimp"></a>AVS模块参数结构体指针。</p>
</td>
<td class="cellrowborder" valign="top" width="22.220000000000002%" headers="mcps1.1.4.1.3 "><p id="p484mcpsimp"><a name="p484mcpsimp"></a><a name="p484mcpsimp"></a>输出</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table486mcpsimp"></a>
<table><thead align="left"><tr id="row491mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p493mcpsimp"><a name="p493mcpsimp"></a><a name="p493mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p495mcpsimp"><a name="p495mcpsimp"></a><a name="p495mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row497mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p499mcpsimp"><a name="p499mcpsimp"></a><a name="p499mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p501mcpsimp"><a name="p501mcpsimp"></a><a name="p501mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row502mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p504mcpsimp"><a name="p504mcpsimp"></a><a name="p504mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p506mcpsimp"><a name="p506mcpsimp"></a><a name="p506mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

AVS模块要加载后才能获取模块参数。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_set\_mod\_param](#ss_mpi_avs_set_mod_param)

### ss\_mpi\_avs\_set\_mod\_param<a name="ZH-CN_TOPIC_0000002408258086"></a>

【描述】

设置AVS模块参数。

【语法】

```
td_s32 ss_mpi_avs_set_mod_param(const ot_avs_mod_param *mod_param);
```

【参数】

<a name="table528mcpsimp"></a>
<table><thead align="left"><tr id="row534mcpsimp"><th class="cellrowborder" valign="top" width="23%" id="mcps1.1.4.1.1"><p id="p536mcpsimp"><a name="p536mcpsimp"></a><a name="p536mcpsimp"></a>参数名称</p>
</th>
<th class="cellrowborder" valign="top" width="57.99999999999999%" id="mcps1.1.4.1.2"><p id="p538mcpsimp"><a name="p538mcpsimp"></a><a name="p538mcpsimp"></a>描述</p>
</th>
<th class="cellrowborder" valign="top" width="19%" id="mcps1.1.4.1.3"><p id="p540mcpsimp"><a name="p540mcpsimp"></a><a name="p540mcpsimp"></a>输入/输出</p>
</th>
</tr>
</thead>
<tbody><tr id="row542mcpsimp"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.1.4.1.1 "><p xml:lang="sv-SE" id="p544mcpsimp"><a name="p544mcpsimp"></a><a name="p544mcpsimp"></a>mod_param</p>
</td>
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.1.4.1.2 "><p id="p546mcpsimp"><a name="p546mcpsimp"></a><a name="p546mcpsimp"></a>AVS模块参数结构体指针。</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.1.4.1.3 "><p id="p548mcpsimp"><a name="p548mcpsimp"></a><a name="p548mcpsimp"></a>输入</p>
</td>
</tr>
</tbody>
</table>

【返回值】

<a name="table550mcpsimp"></a>
<table><thead align="left"><tr id="row555mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p557mcpsimp"><a name="p557mcpsimp"></a><a name="p557mcpsimp"></a>返回值</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p559mcpsimp"><a name="p559mcpsimp"></a><a name="p559mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row561mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p563mcpsimp"><a name="p563mcpsimp"></a><a name="p563mcpsimp"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p565mcpsimp"><a name="p565mcpsimp"></a><a name="p565mcpsimp"></a>成功。</p>
</td>
</tr>
<tr id="row566mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p568mcpsimp"><a name="p568mcpsimp"></a><a name="p568mcpsimp"></a>非0</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p570mcpsimp"><a name="p570mcpsimp"></a><a name="p570mcpsimp"></a>失败，请参见<span xml:lang="fr-FR" id="ph1323142624211"><a name="ph1323142624211"></a><a name="ph1323142624211"></a><a href="错误码.md">错误码</a></span>。</p>
</td>
</tr>
</tbody>
</table>

【需求】

-   头文件：ot\_common\_avs.h、ss\_mpi\_avs.h
-   库文件：libss\_mpi.a

【注意】

-   AVS模块必须已经加载。
-   该接口应该在创建第一个AVS融合拼接组之前调用，否则不会生效。
-   如果不调用该接口，系统会使用默认值。

【举例】

无。

【相关主题】

[ss\_mpi\_avs\_get\_mod\_param](#ss_mpi_avs_get_mod_param)

## 数据类型<a name="ZH-CN_TOPIC_0000002441657581"></a>

AVS模块相关数据类型定义如下：

-   [OT\_AVS\_MAX\_GRP\_NUM](OT_AVS_MAX_GRP_NUM.md)：定义AVS最大GROUP个数。
-   [OT\_AVS\_PIPE\_NUM](OT_AVS_PIPE_NUM.md)：定义AVS最大PIPE个数。
-   [OT\_AVS\_MAX\_CHN\_NUM](OT_AVS_MAX_CHN_NUM.md)：定义AVS最大通道个数。
-   [OT\_AVS\_SPLIT\_NUM](OT_AVS_SPLIT_NUM.md)：定义AVS分割拼接的分割数。
-   [OT\_AVS\_SPLIT\_PIPE\_NUM](OT_AVS_SPLIT_PIPE_NUM.md)：定义AVS在分割拼接时一个分割中最多的拼接路数。
-   [OT\_AVS\_CUBE\_MAP\_SURFACE\_NUM](OT_AVS_CUBE_MAP_SURFACE_NUM.md)：定义AVS立方体投影的面的个数。
-   [OT\_AVS\_MAX\_IN\_WIDTH](OT_AVS_MAX_IN_WIDTH.md)：定义AVS输入图像的最大宽度。
-   [OT\_AVS\_MAX\_IN\_HEIGHT](OT_AVS_MAX_IN_HEIGHT.md)：定义AVS输入图像的最大高度。
-   [OT\_AVS\_BLEND\_MIN\_IN\_WIDTH](OT_AVS_BLEND_MIN_IN_WIDTH.md)：定义AVS融合拼接时输入图像的最小宽度。
-   [OT\_AVS\_BLEND\_MIN\_IN\_HEIGHT](OT_AVS_BLEND_MIN_IN_HEIGHT.md)：定义AVS融合拼接时输入图像的最小高度。
-   [OT\_AVS\_NO\_BLEND\_MIN\_IN\_WIDTH](OT_AVS_NO_BLEND_MIN_IN_WIDTH.md)：定义AVS非融合拼接时输入图像的最小宽度。
-   [OT\_AVS\_NO\_BLEND\_MIN\_IN\_HEIGHT](OT_AVS_NO_BLEND_MIN_IN_HEIGHT.md)：定义AVS非融合拼接时输入图像的最小高度。
-   [OT\_AVS\_MAX\_OUT\_WIDTH](OT_AVS_MAX_OUT_WIDTH.md)：定义AVS输出图像的最大宽度。
-   [OT\_AVS\_MAX\_OUT\_HEIGHT](OT_AVS_MAX_OUT_HEIGHT.md)：定义AVS输出图像的最大高度。
-   [OT\_AVS\_MIN\_OUT\_WIDTH](OT_AVS_MIN_OUT_WIDTH.md)：定义AVS融合拼接时输出图像的最小宽度。
-   [OT\_AVS\_MIN\_OUT\_HEIGHT](OT_AVS_MIN_OUT_HEIGHT.md)：定义AVS融合拼接时输出图像的最小高度。
-   [ot\_avs\_grp](ot_avs_grp.md)：定义AVS GROUP类型。
-   [ot\_avs\_pipe](ot_avs_pipe.md)：定义AVS PIPE类型。
-   [ot\_avs\_chn](ot_avs_chn.md)：定义AVS通道类型。
-   [ot\_avs\_mode](ot_avs_mode.md)：定义AVS工作模式。
-   [ot\_avs\_lut\_accuracy](ot_avs_lut_accuracy.md)：定义查找表的精度。
-   [ot\_avs\_lut](ot_avs_lut.md)：定义查找表属性。
-   [ot\_avs\_projection\_mode](ot_avs_projection_mode.md)：定义拼接输出投影模式。
-   [ot\_avs\_gain\_mode](ot_avs_gain_mode.md)：定义亮度增益补偿模式。
-   [ot\_avs\_gain\_attr](ot_avs_gain_attr.md)：定义亮度增益补偿属性。
-   [ot\_avs\_rotation](ot_avs_rotation.md)：定义AVS旋转属性。
-   [ot\_avs\_fov](ot_avs_fov.md)：定义AVS视场角。
-   [ot\_avs\_split\_attr](ot_avs_split_attr.md)：定义分割属性。
-   [ot\_avs\_cube\_map\_attr](ot_avs_cube_map_attr.md)：定义立方体投影属性。
-   [ot\_avs\_out\_attr](ot_avs_out_attr.md)：定义AVS拼接输出属性。
-   [ot\_avs\_grp\_attr](ot_avs_grp_attr.md)：定义AVS GROUP属性。
-   [ot\_avs\_chn\_attr](ot_avs_chn_attr.md)：定义AVS通道属性。
-   [ot\_avs\_mod\_param](ot_avs_mod_param.md)：定义AVS模块参数。


































### OT\_AVS\_MAX\_GRP\_NUM<a name="ZH-CN_TOPIC_0000002408258334"></a>

【说明】

定义AVS最大GROUP个数。

【定义】

```
#define OT_AVS_MAX_GRP_NUM          32
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_PIPE\_NUM<a name="ZH-CN_TOPIC_0000002441697329"></a>

【说明】

定义AVS最大PIPE个数。

【定义】

```
#define OT_AVS_PIPE_NUM             4
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MAX\_CHN\_NUM<a name="ZH-CN_TOPIC_0000002408258170"></a>

【说明】

定义AVS最大通道个数。

【定义】

```
#define OT_AVS_MAX_CHN_NUM          2
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_SPLIT\_NUM<a name="ZH-CN_TOPIC_0000002441697369"></a>

【说明】

定义AVS分割拼接的分割数。

【定义】

```
#define OT_AVS_SPLIT_NUM            2
```

【注意事项】

该宏定义在SS928V100上没有意义。

【相关数据类型及接口】

无。

### OT\_AVS\_SPLIT\_PIPE\_NUM<a name="ZH-CN_TOPIC_0000002408258226"></a>

【说明】

定义AVS在分割拼接时一个分割中最多的拼接路数。

【定义】

```
#define OT_AVS_SPLIT_PIPE_NUM       4
```

【注意事项】

该宏定义在SS928V100上没有意义。

【相关数据类型及接口】

无。

### OT\_AVS\_CUBE\_MAP\_SURFACE\_NUM<a name="ZH-CN_TOPIC_0000002408098322"></a>

【说明】

定义AVS立方体投影的面的个数。

【定义】

```
#define OT_AVS_CUBE_MAP_SURFACE_NUM   6
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MAX\_IN\_WIDTH<a name="ZH-CN_TOPIC_0000002441657505"></a>

【说明】

定义AVS输入图像的最大宽度。

【定义】

```
#define OT_AVS_MAX_IN_WIDTH         8192
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MAX\_IN\_HEIGHT<a name="ZH-CN_TOPIC_0000002408098214"></a>

【说明】

定义AVS输入图像的最大高度。

【定义】

```
#define OT_AVS_MAX_IN_HEIGHT        8192
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_BLEND\_MIN\_IN\_WIDTH<a name="ZH-CN_TOPIC_0000002441657741"></a>

【说明】

定义AVS融合拼接时输入图像的最小宽度。

【定义】

```
#define OT_AVS_BLEND_MIN_IN_WIDTH         1280
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_BLEND\_MIN\_IN\_HEIGHT<a name="ZH-CN_TOPIC_0000002441697337"></a>

【说明】

定义AVS融合拼接时输入图像的最小高度。

【定义】

```
#define OT_AVS_BLEND_MIN_IN_HEIGHT        720
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_NO\_BLEND\_MIN\_IN\_WIDTH<a name="ZH-CN_TOPIC_0000002408098166"></a>

【说明】

定义AVS非融合拼接时输入图像的最小宽度。

【定义】

```
#define OT_AVS_NO_BLEND_MIN_IN_WIDTH         64
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_NO\_BLEND\_MIN\_IN\_HEIGHT<a name="ZH-CN_TOPIC_0000002441657549"></a>

【说明】

定义AVS非融合拼接时输入图像的最小高度。

【定义】

```
#define OT_AVS_NO_BLEND_MIN_IN_HEIGHT        64
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MAX\_OUT\_WIDTH<a name="ZH-CN_TOPIC_0000002441657657"></a>

【说明】

定义AVS输出图像的最大宽度。

【定义】

```
#define OT_AVS_MAX_OUT_WIDTH        16384
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MAX\_OUT\_HEIGHT<a name="ZH-CN_TOPIC_0000002441697473"></a>

【说明】

定义AVS输出图像的最大高度。

【定义】

```
#define OT_AVS_MAX_OUT_HEIGHT       8192
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MIN\_OUT\_WIDTH<a name="ZH-CN_TOPIC_0000002408098198"></a>

【说明】

定义AVS融合拼接时输出图像的最小宽度。

【定义】

```
#define OT_AVS_MIN_OUT_WIDTH        256
```

【注意事项】

无。

【相关数据类型及接口】

无。

### OT\_AVS\_MIN\_OUT\_HEIGHT<a name="ZH-CN_TOPIC_0000002441697389"></a>

【说明】

定义AVS融合拼接时输出图像的最小高度。

【定义】

```
#define OT_AVS_MIN_OUT_HEIGHT       256
```

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_grp<a name="ZH-CN_TOPIC_0000002408258270"></a>

【说明】

定义AVS GROUP类型。

【定义】

```
typedef   td_s32 ot_avs_grp;
```

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_pipe<a name="ZH-CN_TOPIC_0000002441657681"></a>

【说明】

定义AVS PIPE类型。

【定义】

```
typedef   td_s32 ot_avs_pipe;
```

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_chn<a name="ZH-CN_TOPIC_0000002441657513"></a>

【说明】

定义AVS通道类型。

【定义】

```
typedef   td_s32 ot_avs_chn;
```

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_mode<a name="ZH-CN_TOPIC_0000002408258138"></a>

【说明】

定义AVS工作模式。

【定义】

```
typedef enum {
    OT_AVS_MODE_BLEND = 0,
    OT_AVS_MODE_NOBLEND_VER = 1,
    OT_AVS_MODE_NOBLEND_HOR = 2,
    OT_AVS_MODE_NOBLEND_QR = 3,
    OT_AVS_MODE_BUTT
} ot_avs_mode;
```

【成员】

<a name="table914mcpsimp"></a>
<table><thead align="left"><tr id="row919mcpsimp"><th class="cellrowborder" valign="top" width="37.86%" id="mcps1.1.3.1.1"><p id="p921mcpsimp"><a name="p921mcpsimp"></a><a name="p921mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="62.13999999999999%" id="mcps1.1.3.1.2"><p id="p923mcpsimp"><a name="p923mcpsimp"></a><a name="p923mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row925mcpsimp"><td class="cellrowborder" valign="top" width="37.86%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="OT_AVS_MODE_BLEND"><a name="OT_AVS_MODE_BLEND"></a><a name="OT_AVS_MODE_BLEND"></a>OT_AVS_MODE_BLEND</p>
</td>
<td class="cellrowborder" valign="top" width="62.13999999999999%" headers="mcps1.1.3.1.2 "><p id="p928mcpsimp"><a name="p928mcpsimp"></a><a name="p928mcpsimp"></a>融合拼接模式，根据LUT拼接，在拼接处有融合。</p>
</td>
</tr>
<tr id="row929mcpsimp"><td class="cellrowborder" valign="top" width="37.86%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="OT_AVS_MODE_NOBLEND_VER"><a name="OT_AVS_MODE_NOBLEND_VER"></a><a name="OT_AVS_MODE_NOBLEND_VER"></a>OT_AVS_MODE_NOBLEND_VER</p>
</td>
<td class="cellrowborder" valign="top" width="62.13999999999999%" headers="mcps1.1.3.1.2 "><p id="p932mcpsimp"><a name="p932mcpsimp"></a><a name="p932mcpsimp"></a>垂直非融合拼接模式。将输入的各路图像垂直放在一起，拼接处没有融合。</p>
</td>
</tr>
<tr id="row933mcpsimp"><td class="cellrowborder" valign="top" width="37.86%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="OT_AVS_MODE_NOBLEND_HOR"><a name="OT_AVS_MODE_NOBLEND_HOR"></a><a name="OT_AVS_MODE_NOBLEND_HOR"></a>OT_AVS_MODE_NOBLEND_HOR</p>
</td>
<td class="cellrowborder" valign="top" width="62.13999999999999%" headers="mcps1.1.3.1.2 "><p id="p936mcpsimp"><a name="p936mcpsimp"></a><a name="p936mcpsimp"></a>水平非融合拼接模式。将输入的各路图像水平放在一起，拼接处没有融合。</p>
</td>
</tr>
<tr id="row937mcpsimp"><td class="cellrowborder" valign="top" width="37.86%" headers="mcps1.1.3.1.1 "><p id="OT_AVS_MODE_NOBLEND_QR"><a name="OT_AVS_MODE_NOBLEND_QR"></a><a name="OT_AVS_MODE_NOBLEND_QR"></a>OT_AVS_MODE_NOBLEND_QR</p>
</td>
<td class="cellrowborder" valign="top" width="62.13999999999999%" headers="mcps1.1.3.1.2 "><p id="p940mcpsimp"><a name="p940mcpsimp"></a><a name="p940mcpsimp"></a>田字形非融合拼接模式。仅支持4路图像的拼接，两行摆放，每行两路放在一起，拼接处没有融合。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   [OT\_AVS\_MODE\_BLEND](#OT_AVS_MODE_BLEND)模式下，写出图像的宽高和动态范围属性由通道属性决定；在[OT\_AVS\_MODE\_NOBLEND\_VER](#OT_AVS_MODE_NOBLEND_VER)、[OT\_AVS\_MODE\_NOBLEND\_HOR](#OT_AVS_MODE_NOBLEND_HOR)和[OT\_AVS\_MODE\_NOBLEND\_QR](#OT_AVS_MODE_NOBLEND_QR)模式下，写出图像的宽高和动态范围由输入图像决定。
-   [OT\_AVS\_MODE\_BLEND](#OT_AVS_MODE_BLEND)模式下，支持多个通道写出，[OT\_AVS\_MODE\_NOBLEND\_VER](#OT_AVS_MODE_NOBLEND_VER)、[OT\_AVS\_MODE\_NOBLEND\_HOR](#OT_AVS_MODE_NOBLEND_HOR)和[OT\_AVS\_MODE\_NOBLEND\_QR](#OT_AVS_MODE_NOBLEND_QR)模式下，只支持一个通道写出。
-   在[OT\_AVS\_MODE\_NOBLEND\_HOR](#OT_AVS_MODE_NOBLEND_HOR)模式下，压缩写出时，拼接路数不能超过4路。
-   AVS\_MODE\_NOBLEND\_QR模式，仅支持4路的拼接；
-   各模式下最大最小的输入分辨率如[表1](#_Ref505871381)所示，除了表格的限制外，非融合模式要求最大输出不超过16384x8192，如在4路垂直硬拼时，最终输出的高为每路输入图像高度的4倍，即每路输入图像最大高度为2048。

**表 1**  各模式下的输入分辨率

<a name="_Ref505871381"></a>
<table><thead align="left"><tr id="row969mcpsimp"><th class="cellrowborder" rowspan="2" valign="top" id="mcps1.2.6.1.1"><p id="p971mcpsimp"><a name="p971mcpsimp"></a><a name="p971mcpsimp"></a>拼接模式</p>
</th>
<th class="cellrowborder" colspan="4" valign="top" id="mcps1.2.6.1.2"><p id="p973mcpsimp"><a name="p973mcpsimp"></a><a name="p973mcpsimp"></a>分辨率</p>
</th>
</tr>
<tr id="row974mcpsimp"><th class="cellrowborder" valign="top" id="mcps1.2.6.2.1"><p id="p976mcpsimp"><a name="p976mcpsimp"></a><a name="p976mcpsimp"></a>最小宽度</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.6.2.2"><p id="p978mcpsimp"><a name="p978mcpsimp"></a><a name="p978mcpsimp"></a>最大宽度</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.6.2.3"><p id="p980mcpsimp"><a name="p980mcpsimp"></a><a name="p980mcpsimp"></a>最小高度</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.6.2.4"><p id="p982mcpsimp"><a name="p982mcpsimp"></a><a name="p982mcpsimp"></a>最大高度</p>
</th>
</tr>
</thead>
<tbody><tr id="row984mcpsimp"><td class="cellrowborder" valign="top" width="14.288571142885715%" headers="mcps1.2.6.1.1 mcps1.2.6.2.1 "><p xml:lang="sv-SE" id="p986mcpsimp"><a name="p986mcpsimp"></a><a name="p986mcpsimp"></a>BLEND</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.2 "><p id="p988mcpsimp"><a name="p988mcpsimp"></a><a name="p988mcpsimp"></a>OT_AVS_BLEND_MIN_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.3 "><p xml:lang="sv-SE" id="p990mcpsimp"><a name="p990mcpsimp"></a><a name="p990mcpsimp"></a>OT_AVS_MAX_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.4 "><p id="p992mcpsimp"><a name="p992mcpsimp"></a><a name="p992mcpsimp"></a>OT_AVS_BLEND_MIN_IN_HEIGHT</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 "><p xml:lang="sv-SE" id="p994mcpsimp"><a name="p994mcpsimp"></a><a name="p994mcpsimp"></a>OT_AVS_MAX_IN_HEIGHT</p>
</td>
</tr>
<tr id="row995mcpsimp"><td class="cellrowborder" valign="top" width="14.288571142885715%" headers="mcps1.2.6.1.1 mcps1.2.6.2.1 "><p xml:lang="sv-SE" id="p997mcpsimp"><a name="p997mcpsimp"></a><a name="p997mcpsimp"></a>NOBLEND_VER</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.2 "><p id="p999mcpsimp"><a name="p999mcpsimp"></a><a name="p999mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.3 "><p xml:lang="sv-SE" id="p1001mcpsimp"><a name="p1001mcpsimp"></a><a name="p1001mcpsimp"></a>OT_AVS_MAX_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.4 "><p id="p1003mcpsimp"><a name="p1003mcpsimp"></a><a name="p1003mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_HEIGHT</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 "><p xml:lang="sv-SE" id="p1005mcpsimp"><a name="p1005mcpsimp"></a><a name="p1005mcpsimp"></a>OT_AVS_MAX_IN_HEIGHT</p>
</td>
</tr>
<tr id="row1006mcpsimp"><td class="cellrowborder" valign="top" width="14.288571142885715%" headers="mcps1.2.6.1.1 mcps1.2.6.2.1 "><p xml:lang="sv-SE" id="p1008mcpsimp"><a name="p1008mcpsimp"></a><a name="p1008mcpsimp"></a>NOBLEND_HOR</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.2 "><p id="p1010mcpsimp"><a name="p1010mcpsimp"></a><a name="p1010mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.3 "><p id="p1012mcpsimp"><a name="p1012mcpsimp"></a><a name="p1012mcpsimp"></a>4096</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.4 "><p id="p1014mcpsimp"><a name="p1014mcpsimp"></a><a name="p1014mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_HEIGHT</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 "><p xml:lang="sv-SE" id="p1016mcpsimp"><a name="p1016mcpsimp"></a><a name="p1016mcpsimp"></a>OT_AVS_MAX_IN_HEIGHT</p>
</td>
</tr>
<tr id="row1017mcpsimp"><td class="cellrowborder" valign="top" width="14.288571142885715%" headers="mcps1.2.6.1.1 mcps1.2.6.2.1 "><p id="p1019mcpsimp"><a name="p1019mcpsimp"></a><a name="p1019mcpsimp"></a>NOBLEND_QR</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.2 "><p id="p1021mcpsimp"><a name="p1021mcpsimp"></a><a name="p1021mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_WIDTH</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.3 "><p id="p1023mcpsimp"><a name="p1023mcpsimp"></a><a name="p1023mcpsimp"></a>4096</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 mcps1.2.6.2.4 "><p id="p1025mcpsimp"><a name="p1025mcpsimp"></a><a name="p1025mcpsimp"></a>OT_AVS_NO_BLEND_MIN_IN_HEIGHT</p>
</td>
<td class="cellrowborder" valign="top" width="21.427857214278575%" headers="mcps1.2.6.1.2 "><p xml:lang="sv-SE" id="p1027mcpsimp"><a name="p1027mcpsimp"></a><a name="p1027mcpsimp"></a>OT_AVS_MAX_IN_HEIGHT</p>
</td>
</tr>
</tbody>
</table>

【相关数据类型及接口】

无

### ot\_avs\_lut\_accuracy<a name="ZH-CN_TOPIC_0000002408258250"></a>

【说明】

定义查找表的精度。

【定义】

```
typedef enum {
    OT_AVS_LUT_ACCURACY_HIGH = 0, 
    OT_AVS_LUT_ACCURACY_LOW = 1, 
    OT_AVS_LUT_ACCURACY_BUTT
} ot_avs_lut_accuracy;
```

【成员】

<a name="table1040mcpsimp"></a>
<table><thead align="left"><tr id="row1045mcpsimp"><th class="cellrowborder" valign="top" width="44%" id="mcps1.1.3.1.1"><p id="p1047mcpsimp"><a name="p1047mcpsimp"></a><a name="p1047mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="56.00000000000001%" id="mcps1.1.3.1.2"><p id="p1049mcpsimp"><a name="p1049mcpsimp"></a><a name="p1049mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1051mcpsimp"><td class="cellrowborder" valign="top" width="44%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1053mcpsimp"><a name="p1053mcpsimp"></a><a name="p1053mcpsimp"></a>OT_AVS_LUT_ACCURACY_HIGH</p>
</td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.1.3.1.2 "><p id="p1055mcpsimp"><a name="p1055mcpsimp"></a><a name="p1055mcpsimp"></a>查找表高精度。</p>
</td>
</tr>
<tr id="row1056mcpsimp"><td class="cellrowborder" valign="top" width="44%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1058mcpsimp"><a name="p1058mcpsimp"></a><a name="p1058mcpsimp"></a>OT_AVS_LUT_ACCURACY_LOW</p>
</td>
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.1.3.1.2 "><p id="p1060mcpsimp"><a name="p1060mcpsimp"></a><a name="p1060mcpsimp"></a>查找表低精度。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   查找表的精度须与标定时的精度选择一致，否则AVS无法正常工作。
-   查找表精度高，拼接更准确，但拼接性能会比低精度查找表时有所下降。

【相关数据类型及接口】

无。

### ot\_avs\_lut<a name="ZH-CN_TOPIC_0000002441697405"></a>

【说明】

定义查找表属性。

【定义】

```
typedef struct {
    ot_avs_lut_accuracy accuracy; 
    td_phys_addr_t phys_addr[OT_AVS_PIPE_NUM];
} ot_avs_lut;
```

【成员】

<a name="table1081mcpsimp"></a>
<table><thead align="left"><tr id="row1086mcpsimp"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p1088mcpsimp"><a name="p1088mcpsimp"></a><a name="p1088mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p1090mcpsimp"><a name="p1090mcpsimp"></a><a name="p1090mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1092mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1094mcpsimp"><a name="p1094mcpsimp"></a><a name="p1094mcpsimp"></a>accuracy</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1096mcpsimp"><a name="p1096mcpsimp"></a><a name="p1096mcpsimp"></a>查找表的精度，须和标定的配置一致。</p>
</td>
</tr>
<tr id="row1097mcpsimp"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1099mcpsimp"><a name="p1099mcpsimp"></a><a name="p1099mcpsimp"></a>phys_addr[<a href="OT_AVS_PIPE_NUM.md">OT_AVS_PIPE_NUM</a>]</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p1102mcpsimp"><a name="p1102mcpsimp"></a><a name="p1102mcpsimp"></a>各路查找表的物理地址，查找表数据来自标定。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   phys\_addr要求256对齐，并且是有效的MMZ内存。
-   用户须保证查找表的物理地址和其中的内容正确有效，不然可能会发生卡死的情况。
-   accuracy须和标定时候的值一致。

【相关数据类型及接口】

[ot\_avs\_out\_attr](#ot_avs_out_attr)

### ot\_avs\_projection\_mode<a name="ZH-CN_TOPIC_0000002408098382"></a>

【说明】

定义拼接输出投影模式。

【定义】

```
typedef enum {
    OT_AVS_PROJECTION_EQUIRECTANGULAR = 0, 
    OT_AVS_PROJECTION_RECTILINEAR = 1, 
    OT_AVS_PROJECTION_CYLINDRICAL = 2, 
    OT_AVS_PROJECTION_CUBE_MAP = 3, 
    OT_AVS_PROJECTION_BUTT
} ot_avs_projection_mode;
```

【成员】

<a name="table1124mcpsimp"></a>
<table><thead align="left"><tr id="row1129mcpsimp"><th class="cellrowborder" valign="top" width="60%" id="mcps1.1.3.1.1"><p id="p1131mcpsimp"><a name="p1131mcpsimp"></a><a name="p1131mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="40%" id="mcps1.1.3.1.2"><p id="p1133mcpsimp"><a name="p1133mcpsimp"></a><a name="p1133mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1135mcpsimp"><td class="cellrowborder" valign="top" width="60%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1137mcpsimp"><a name="p1137mcpsimp"></a><a name="p1137mcpsimp"></a>OT_AVS_PROJECTION_EQUIRECTANGULAR</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.1.3.1.2 "><p id="p1139mcpsimp"><a name="p1139mcpsimp"></a><a name="p1139mcpsimp"></a>等距柱面投影模式。</p>
</td>
</tr>
<tr id="row1140mcpsimp"><td class="cellrowborder" valign="top" width="60%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1142mcpsimp"><a name="p1142mcpsimp"></a><a name="p1142mcpsimp"></a>OT_AVS_PROJECTION_RECTILINEAR</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.1.3.1.2 "><p id="p1144mcpsimp"><a name="p1144mcpsimp"></a><a name="p1144mcpsimp"></a>直线投影模式。</p>
</td>
</tr>
<tr id="row1145mcpsimp"><td class="cellrowborder" valign="top" width="60%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1147mcpsimp"><a name="p1147mcpsimp"></a><a name="p1147mcpsimp"></a>OT_AVS_PROJECTION_CYLINDRICAL</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.1.3.1.2 "><p id="p1149mcpsimp"><a name="p1149mcpsimp"></a><a name="p1149mcpsimp"></a>柱面投影模式。</p>
</td>
</tr>
<tr id="row1150mcpsimp"><td class="cellrowborder" valign="top" width="60%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="AVS_PROJECTION_CUBE_MAP"><a name="AVS_PROJECTION_CUBE_MAP"></a><a name="AVS_PROJECTION_CUBE_MAP"></a>OT_AVS_PROJECTION_CUBE_MAP</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.1.3.1.2 "><p id="p1153mcpsimp"><a name="p1153mcpsimp"></a><a name="p1153mcpsimp"></a>立方体投影模式。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_gain\_mode<a name="ZH-CN_TOPIC_0000002441657565"></a>

【说明】

定义亮度增益补偿模式。

【定义】

```
typedef enum {
    OT_AVS_GAIN_MODE_MANUAL = 0, 
    OT_AVS_GAIN_MODE_AUTO = 1, 
    OT_AVS_GAIN_MODE_BUTT
} ot_avs_gain_mode;
```

【成员】

<a name="table1169mcpsimp"></a>
<table><thead align="left"><tr id="row1174mcpsimp"><th class="cellrowborder" valign="top" width="45%" id="mcps1.1.3.1.1"><p id="p1176mcpsimp"><a name="p1176mcpsimp"></a><a name="p1176mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="55.00000000000001%" id="mcps1.1.3.1.2"><p id="p1178mcpsimp"><a name="p1178mcpsimp"></a><a name="p1178mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1180mcpsimp"><td class="cellrowborder" valign="top" width="45%" headers="mcps1.1.3.1.1 "><p xml:lang="de-DE" id="p1182mcpsimp"><a name="p1182mcpsimp"></a><a name="p1182mcpsimp"></a>OT_AVS_GAIN_MODE_MANUAL</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.1.3.1.2 "><p id="p1184mcpsimp"><a name="p1184mcpsimp"></a><a name="p1184mcpsimp"></a>手动模式，用户手动配置亮度增益补偿值。</p>
</td>
</tr>
<tr id="row1185mcpsimp"><td class="cellrowborder" valign="top" width="45%" headers="mcps1.1.3.1.1 "><p xml:lang="de-DE" id="p1187mcpsimp"><a name="p1187mcpsimp"></a><a name="p1187mcpsimp"></a><span xml:lang="en-US" id="ph1188mcpsimp"><a name="ph1188mcpsimp"></a><a name="ph1188mcpsimp"></a>OT_AVS</span>_GAIN_MODE_AUTO</p>
</td>
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.1.3.1.2 "><p id="p1190mcpsimp"><a name="p1190mcpsimp"></a><a name="p1190mcpsimp"></a>自动模式，AVS自动统计拼接处的亮度差异，自动进行亮度增益补偿。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   如果创建了多个使用[OT\_AVS\_MODE\_BLEND](ot_avs_mode.md#OT_AVS_MODE_BLEND)模式的AVS GROUP，只能使用手动模式。
-   使用[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)投影模式时，只能使用手动模式。
-   自动模式下，AVS亮度增益补偿滞后一帧。

【相关数据类型及接口】

无。

### ot\_avs\_gain\_attr<a name="ZH-CN_TOPIC_0000002408098346"></a>

【说明】

定义亮度增益补偿属性。

【定义】

```
typedef struct {
    ot_avs_gain_mode mode;
    td_s32 coef[OT_AVS_PIPE_NUM];
} ot_avs_gain_attr;
```

【成员】

<a name="table1215mcpsimp"></a>
<table><thead align="left"><tr id="row1220mcpsimp"><th class="cellrowborder" valign="top" width="48%" id="mcps1.1.3.1.1"><p id="p1222mcpsimp"><a name="p1222mcpsimp"></a><a name="p1222mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="52%" id="mcps1.1.3.1.2"><p id="p1224mcpsimp"><a name="p1224mcpsimp"></a><a name="p1224mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1226mcpsimp"><td class="cellrowborder" valign="top" width="48%" headers="mcps1.1.3.1.1 "><p xml:lang="de-DE" id="p1228mcpsimp"><a name="p1228mcpsimp"></a><a name="p1228mcpsimp"></a>mode</p>
</td>
<td class="cellrowborder" valign="top" width="52%" headers="mcps1.1.3.1.2 "><p id="p1230mcpsimp"><a name="p1230mcpsimp"></a><a name="p1230mcpsimp"></a>亮度增益补偿模式。</p>
</td>
</tr>
<tr id="row1231mcpsimp"><td class="cellrowborder" valign="top" width="48%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1233mcpsimp"><a name="p1233mcpsimp"></a><a name="p1233mcpsimp"></a><span xml:lang="de-DE" id="ph1234mcpsimp"><a name="ph1234mcpsimp"></a><a name="ph1234mcpsimp"></a>coef[</span><a href="OT_AVS_PIPE_NUM.md">OT_AVS_PIPE_NUM</a><span xml:lang="de-DE" id="ph1236mcpsimp"><a name="ph1236mcpsimp"></a><a name="ph1236mcpsimp"></a>]</span></p>
</td>
<td class="cellrowborder" valign="top" width="52%" headers="mcps1.1.3.1.2 "><p id="p1238mcpsimp"><a name="p1238mcpsimp"></a><a name="p1238mcpsimp"></a>在手动模式下的各路亮度增益值。取值范围：[0, 65535], 配置为16384时亮度不校正，比16384小时图像变暗，比16384大时图像变亮。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   coef\[[OT\_AVS\_PIPE\_NUM](OT_AVS_PIPE_NUM.md)\]只有在手动模式下才有效。
-   使用[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)投影模式时，只能使用手动模式，并且各路增益值要求一致。
-   亮度增益模块虽然支持0\~4倍调整，实际使用时建议控制在合理范围内调整，当增益倍数大于2倍时，图像较容易产生对比度过强、细节损失等不自然现象。

【相关数据类型及接口】

无。

### ot\_avs\_rotation<a name="ZH-CN_TOPIC_0000002441697529"></a>

【说明】

定义AVS旋转属性。

【定义】

```
typedef struct {
    td_s32 yaw; 
    td_s32 pitch; 
    td_s32 roll; 
} ot_avs_rotation;
```

【成员】

<a name="table1259mcpsimp"></a>
<table><thead align="left"><tr id="row1264mcpsimp"><th class="cellrowborder" valign="top" width="30%" id="mcps1.1.3.1.1"><p id="p1266mcpsimp"><a name="p1266mcpsimp"></a><a name="p1266mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.3.1.2"><p id="p1268mcpsimp"><a name="p1268mcpsimp"></a><a name="p1268mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1270mcpsimp"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.1.3.1.1 "><p id="p1272mcpsimp"><a name="p1272mcpsimp"></a><a name="p1272mcpsimp"></a>yaw</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1274mcpsimp"><a name="p1274mcpsimp"></a><a name="p1274mcpsimp"></a><span xml:lang="en-US" id="ph1275mcpsimp"><a name="ph1275mcpsimp"></a><a name="ph1275mcpsimp"></a>偏航角</span>，取值范围：[-18000, 18000]，<span xml:lang="en-US" id="ph1276mcpsimp"><a name="ph1276mcpsimp"></a><a name="ph1276mcpsimp"></a>单位：0.01&deg;。</span></p>
</td>
</tr>
<tr id="row1277mcpsimp"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1279mcpsimp"><a name="p1279mcpsimp"></a><a name="p1279mcpsimp"></a>pitch</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1281mcpsimp"><a name="p1281mcpsimp"></a><a name="p1281mcpsimp"></a><span xml:lang="en-US" id="ph1282mcpsimp"><a name="ph1282mcpsimp"></a><a name="ph1282mcpsimp"></a>俯仰角</span>，取值范围：[-18000, 18000]，<span xml:lang="en-US" id="ph1283mcpsimp"><a name="ph1283mcpsimp"></a><a name="ph1283mcpsimp"></a>单位：0.01&deg;。</span></p>
</td>
</tr>
<tr id="row1284mcpsimp"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1286mcpsimp"><a name="p1286mcpsimp"></a><a name="p1286mcpsimp"></a>roll</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1288mcpsimp"><a name="p1288mcpsimp"></a><a name="p1288mcpsimp"></a><span xml:lang="en-US" id="ph1289mcpsimp"><a name="ph1289mcpsimp"></a><a name="ph1289mcpsimp"></a>翻滚角</span>，取值范围：[-18000, 18000]，<span xml:lang="en-US" id="ph1290mcpsimp"><a name="ph1290mcpsimp"></a><a name="ph1290mcpsimp"></a>单位：0.01&deg;。</span></p>
</td>
</tr>
</tbody>
</table>

【注意事项】

无。

【相关数据类型及接口】

无。

### ot\_avs\_fov<a name="ZH-CN_TOPIC_0000002441657521"></a>

【说明】

定义AVS视场角。

【定义】

```
typedef struct {
    td_u32 fov_x; 
    td_u32 fov_y; 
} ot_avs_fov;
```

【成员】

<a name="table1305mcpsimp"></a>
<table><thead align="left"><tr id="row1310mcpsimp"><th class="cellrowborder" valign="top" width="25%" id="mcps1.1.3.1.1"><p id="p1312mcpsimp"><a name="p1312mcpsimp"></a><a name="p1312mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="75%" id="mcps1.1.3.1.2"><p id="p1314mcpsimp"><a name="p1314mcpsimp"></a><a name="p1314mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1316mcpsimp"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.3.1.1 "><p xml:lang="de-DE" id="p1318mcpsimp"><a name="p1318mcpsimp"></a><a name="p1318mcpsimp"></a>fov_x</p>
</td>
<td class="cellrowborder" valign="top" width="75%" headers="mcps1.1.3.1.2 "><p id="p1320mcpsimp"><a name="p1320mcpsimp"></a><a name="p1320mcpsimp"></a>水平方向上的视场角。单位：0.01&deg;</p>
<a name="ul10382945173820"></a><a name="ul10382945173820"></a><ul id="ul10382945173820"><li>当投影模式为EQUIRECTANGULAR时，取值范围：[1000, 36000]；</li><li>当投影模式为RECTILINEAR时，取值范围：[1000, 15000]；</li><li>当投影模式为CYLINDRICAL时，取值范围：[1000, 36000]</li></ul>
</td>
</tr>
<tr id="row1324mcpsimp"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.3.1.1 "><p xml:lang="de-DE" id="p1326mcpsimp"><a name="p1326mcpsimp"></a><a name="p1326mcpsimp"></a>fov_y</p>
</td>
<td class="cellrowborder" valign="top" width="75%" headers="mcps1.1.3.1.2 "><p id="p1328mcpsimp"><a name="p1328mcpsimp"></a><a name="p1328mcpsimp"></a>垂直方向上的视场角。单位：0.01&deg;</p>
<a name="ul35568485382"></a><a name="ul35568485382"></a><ul id="ul35568485382"><li>当投影模式为EQUIRECTANGULAR时，取值范围：[1000, 18000]；</li><li>当投影模式为RECTILINEAR时，取值范围：[1000, 15000]；</li><li>当投影模式为CYLINDRICAL时，取值范围：[1000, 15000]</li></ul>
</td>
</tr>
</tbody>
</table>

【注意事项】

当投影模式为[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)投影模式时，该参数无效。

【相关数据类型及接口】

无。

### ot\_avs\_split\_attr<a name="ZH-CN_TOPIC_0000002408098410"></a>

【说明】

定义分割属性。

【定义】

```
typedef struct {
    td_u32 pipe_num;
    ot_avs_pipe pipe[OT_AVS_SPLIT_PIPE_NUM];
} ot_avs_split_attr;
```

【成员】

<a name="table1351mcpsimp"></a>
<table><thead align="left"><tr id="row1356mcpsimp"><th class="cellrowborder" valign="top" width="54%" id="mcps1.1.3.1.1"><p id="p1358mcpsimp"><a name="p1358mcpsimp"></a><a name="p1358mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="46%" id="mcps1.1.3.1.2"><p id="p1360mcpsimp"><a name="p1360mcpsimp"></a><a name="p1360mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1362mcpsimp"><td class="cellrowborder" valign="top" width="54%" headers="mcps1.1.3.1.1 "><p id="p1364mcpsimp"><a name="p1364mcpsimp"></a><a name="p1364mcpsimp"></a>pipe_num</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1366mcpsimp"><a name="p1366mcpsimp"></a><a name="p1366mcpsimp"></a>该分割拼接中拼接的路数。</p>
</td>
</tr>
<tr id="row1367mcpsimp"><td class="cellrowborder" valign="top" width="54%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1369mcpsimp"><a name="p1369mcpsimp"></a><a name="p1369mcpsimp"></a><span xml:lang="en-US" id="ph1370mcpsimp"><a name="ph1370mcpsimp"></a><a name="ph1370mcpsimp"></a>pipe[</span><a href="OT_AVS_SPLIT_PIPE_NUM.md">OT_AVS_SPLIT_PIPE_NUM</a><span xml:lang="en-US" id="ph1372mcpsimp"><a name="ph1372mcpsimp"></a><a name="ph1372mcpsimp"></a>]</span></p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1374mcpsimp"><a name="p1374mcpsimp"></a><a name="p1374mcpsimp"></a>该分割拼接中用到图像的pipe号。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   用户须保证分割属性的正确性，否则输出图可能会出现黑块。
-   在SS928V100上该参数没有意义。

【相关数据类型及接口】

无。

### ot\_avs\_cube\_map\_attr<a name="ZH-CN_TOPIC_0000002441657617"></a>

【说明】

定义立方体投影属性。

【定义】

```
typedef struct {
    td_bool bg_color_en;
    td_u32 bg_color;
    td_u32 surface_len;
    ot_point start_point[OT_AVS_CUBE_MAP_SURFACE_NUM]; 
} ot_avs_cube_map_attr;
```

【成员】

<a name="table1395mcpsimp"></a>
<table><thead align="left"><tr id="row1400mcpsimp"><th class="cellrowborder" valign="top" width="26%" id="mcps1.1.3.1.1"><p id="p1402mcpsimp"><a name="p1402mcpsimp"></a><a name="p1402mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="74%" id="mcps1.1.3.1.2"><p id="p1404mcpsimp"><a name="p1404mcpsimp"></a><a name="p1404mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1406mcpsimp"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1408mcpsimp"><a name="p1408mcpsimp"></a><a name="p1408mcpsimp"></a>bg_color_en</p>
</td>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1410mcpsimp"><a name="p1410mcpsimp"></a><a name="p1410mcpsimp"></a>是否使能背景色。</p>
</td>
</tr>
<tr id="row1411mcpsimp"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1413mcpsimp"><a name="p1413mcpsimp"></a><a name="p1413mcpsimp"></a>bg_color</p>
</td>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1415mcpsimp"><a name="p1415mcpsimp"></a><a name="p1415mcpsimp"></a>背景色属性，格式RGB888。</p>
</td>
</tr>
<tr id="row1416mcpsimp"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1418mcpsimp"><a name="p1418mcpsimp"></a><a name="p1418mcpsimp"></a>surface_len</p>
</td>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1420mcpsimp"><a name="p1420mcpsimp"></a><a name="p1420mcpsimp"></a>立方体投影的单个面的边长，要求4对齐。取值范围: [256, 4096]</p>
</td>
</tr>
<tr id="row1421mcpsimp"><td class="cellrowborder" valign="top" width="26%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1423mcpsimp"><a name="p1423mcpsimp"></a><a name="p1423mcpsimp"></a>start_point[<a href="OT_AVS_CUBE_MAP_SURFACE_NUM.md">OT_AVS_CUBE_MAP_SURFACE_NUM</a>]</p>
</td>
<td class="cellrowborder" valign="top" width="74%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1426mcpsimp"><a name="p1426mcpsimp"></a><a name="p1426mcpsimp"></a>立方体投影的每一个面在输出图像上的起点位置。不能超出图像，要求4对齐。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   如果未使能背景色，输出图像未铺满的地方会显示随机数据。使能背景色，会增加VGS模块的性能和VB的消耗，如果展开的面填满了输出图像，建议关闭背景色。
-   展开面不能超出输出图像。
-   [OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)展开时，如果输出配置为压缩，则必须使能背景色。
-   [OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)展开时，如果输出配置为压缩，则起点的X坐标要求256对齐，surface\_len也要求256对齐。

【相关数据类型及接口】

无。

### ot\_avs\_out\_attr<a name="ZH-CN_TOPIC_0000002408258154"></a>

【说明】

定义AVS拼接输出属性。

【定义】

```
typedef struct {
    ot_avs_projection_mode projection_mode;
    ot_point center;
    ot_avs_fov fov; 
    ot_avs_rotation orig_rotation;
    ot_avs_rotation rotation; 
    ot_avs_split_attr split_attr[OT_AVS_SPLIT_NUM];
    ot_avs_cube_map_attr cube_map_attr;
} ot_avs_out_attr;
```

【成员】

<a name="table1467mcpsimp"></a>
<table><thead align="left"><tr id="row1472mcpsimp"><th class="cellrowborder" valign="top" width="43%" id="mcps1.1.3.1.1"><p id="p1474mcpsimp"><a name="p1474mcpsimp"></a><a name="p1474mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="56.99999999999999%" id="mcps1.1.3.1.2"><p id="p1476mcpsimp"><a name="p1476mcpsimp"></a><a name="p1476mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1478mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1480mcpsimp"><a name="p1480mcpsimp"></a><a name="p1480mcpsimp"></a>projection_mode</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1482mcpsimp"><a name="p1482mcpsimp"></a><a name="p1482mcpsimp"></a>拼接输出的投影模式。</p>
</td>
</tr>
<tr id="row1483mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1485mcpsimp"><a name="p1485mcpsimp"></a><a name="p1485mcpsimp"></a>center</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1487mcpsimp"><a name="p1487mcpsimp"></a><a name="p1487mcpsimp"></a>投影中心在输出图中的位置。一般设置为输出图像的中心点，表示投影中心和输出图像中心点重合。</p>
</td>
</tr>
<tr id="row1488mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1490mcpsimp"><a name="p1490mcpsimp"></a><a name="p1490mcpsimp"></a>fov</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1492mcpsimp"><a name="p1492mcpsimp"></a><a name="p1492mcpsimp"></a>拼接输出区域的视场角。</p>
</td>
</tr>
<tr id="row1493mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1495mcpsimp"><a name="p1495mcpsimp"></a><a name="p1495mcpsimp"></a>orig_rotation</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1497mcpsimp"><a name="p1497mcpsimp"></a><a name="p1497mcpsimp"></a>拼接输出起始旋转角度属性。</p>
</td>
</tr>
<tr id="row1498mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1500mcpsimp"><a name="p1500mcpsimp"></a><a name="p1500mcpsimp"></a>rotation</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1502mcpsimp"><a name="p1502mcpsimp"></a><a name="p1502mcpsimp"></a>拼接输出旋转属性。</p>
</td>
</tr>
<tr id="row1503mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p id="p1505mcpsimp"><a name="p1505mcpsimp"></a><a name="p1505mcpsimp"></a><span xml:lang="sv-SE" id="ph1506mcpsimp"><a name="ph1506mcpsimp"></a><a name="ph1506mcpsimp"></a>split_attr[</span><a href="OT_AVS_SPLIT_NUM.md">OT_AVS_SPLIT_NUM</a><span xml:lang="sv-SE" id="ph1508mcpsimp"><a name="ph1508mcpsimp"></a><a name="ph1508mcpsimp"></a>]</span></p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p xml:lang="de-DE" id="p1510mcpsimp"><a name="p1510mcpsimp"></a><a name="p1510mcpsimp"></a>分割拼接时的分割属性。</p>
</td>
</tr>
<tr id="row1511mcpsimp"><td class="cellrowborder" valign="top" width="43%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1513mcpsimp"><a name="p1513mcpsimp"></a><a name="p1513mcpsimp"></a>cube_map_attr</p>
</td>
<td class="cellrowborder" valign="top" width="56.99999999999999%" headers="mcps1.1.3.1.2 "><p id="p1515mcpsimp"><a name="p1515mcpsimp"></a><a name="p1515mcpsimp"></a>立方体投影属性。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   split\_attr\[[OT\_AVS\_SPLIT\_NUM](OT_AVS_SPLIT_NUM.md)\]在SS928V100上不支持，设置了不会生效。
-   center投影中心即为三维球面全景图转换到二维投影输出图的投影中心位置，当投影模式为[OT\_AVS\_PROJECTION\_CUBE\_MAP](ot_avs_projection_mode.md#AVS_PROJECTION_CUBE_MAP)时，center不生效。
-   一般情况下，投影中心与输出图像中心重合，即投影输出图的fov上下左右对称。如需要对输出图像进行裁剪，仅显示部分视野，则可减小fov，同时通过移动投影中心点，选择感兴趣的区域作为输出图。
-   投影中心点的X和Y的范围是\(-16384, 16384\)。
-   投影中心和fov需要一起调节，否则输出图会出现黑块或者杂乱的情况。
-   投影中心点移动之后，超出最大fov区域不显示图像，可通过减小fov的配置来裁剪超出部分。

【相关数据类型及接口】

无。

### ot\_avs\_grp\_attr<a name="ZH-CN_TOPIC_0000002441657713"></a>

【说明】

定义AVS GROUP属性。

【定义】

```
typedef struct {
    ot_avs_mode mode;
    td_u32 pipe_num;
    td_bool sync_pipe_en;
    ot_avs_lut lut; 
    ot_avs_gain_attr gain_attr; 
    ot_avs_out_attr out_attr;
    ot_frame_rate_ctrl frame_rate;
} ot_avs_grp_attr;
```

【成员】

<a name="table1553mcpsimp"></a>
<table><thead align="left"><tr id="row1558mcpsimp"><th class="cellrowborder" valign="top" width="28.000000000000004%" id="mcps1.1.3.1.1"><p id="p1560mcpsimp"><a name="p1560mcpsimp"></a><a name="p1560mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="72%" id="mcps1.1.3.1.2"><p id="p1562mcpsimp"><a name="p1562mcpsimp"></a><a name="p1562mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1564mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1566mcpsimp"><a name="p1566mcpsimp"></a><a name="p1566mcpsimp"></a>mode</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p id="p1568mcpsimp"><a name="p1568mcpsimp"></a><a name="p1568mcpsimp"></a>拼接模式。静态属性，创建GROUP时设定，不可更改。</p>
</td>
</tr>
<tr id="row1569mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1571mcpsimp"><a name="p1571mcpsimp"></a><a name="p1571mcpsimp"></a>pipe_num</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1573mcpsimp"><a name="p1573mcpsimp"></a><a name="p1573mcpsimp"></a>PIPE数，即拼接路数。取值范围：[1, <a href="OT_AVS_PIPE_NUM.md">OT_AVS_PIPE_NUM</a>]。静态属性，<span xml:lang="en-US" id="ph1575mcpsimp"><a name="ph1575mcpsimp"></a><a name="ph1575mcpsimp"></a>创建</span>GROUP<span xml:lang="en-US" id="ph1576mcpsimp"><a name="ph1576mcpsimp"></a><a name="ph1576mcpsimp"></a>时设定</span>，<span xml:lang="en-US" id="ph1577mcpsimp"><a name="ph1577mcpsimp"></a><a name="ph1577mcpsimp"></a>不可更改</span>。</p>
</td>
</tr>
<tr id="row1578mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1580mcpsimp"><a name="p1580mcpsimp"></a><a name="p1580mcpsimp"></a>sync_pipe_en</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1582mcpsimp"><a name="p1582mcpsimp"></a><a name="p1582mcpsimp"></a>是否通过PTS进行各路图像的同步。</p>
</td>
</tr>
<tr id="row1583mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1585mcpsimp"><a name="p1585mcpsimp"></a><a name="p1585mcpsimp"></a>lut</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1587mcpsimp"><a name="p1587mcpsimp"></a><a name="p1587mcpsimp"></a>查找表属性。</p>
</td>
</tr>
<tr id="row1588mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1590mcpsimp"><a name="p1590mcpsimp"></a><a name="p1590mcpsimp"></a>gain_attr</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1592mcpsimp"><a name="p1592mcpsimp"></a><a name="p1592mcpsimp"></a>亮度增益补偿属性。</p>
</td>
</tr>
<tr id="row1593mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1595mcpsimp"><a name="p1595mcpsimp"></a><a name="p1595mcpsimp"></a>out_attr</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1597mcpsimp"><a name="p1597mcpsimp"></a><a name="p1597mcpsimp"></a>拼接输出属性。</p>
</td>
</tr>
<tr id="row1598mcpsimp"><td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1600mcpsimp"><a name="p1600mcpsimp"></a><a name="p1600mcpsimp"></a>frame_rate</p>
</td>
<td class="cellrowborder" valign="top" width="72%" headers="mcps1.1.3.1.2 "><p id="p1602mcpsimp"><a name="p1602mcpsimp"></a><a name="p1602mcpsimp"></a><span xml:lang="sv-SE" id="ph1603mcpsimp"><a name="ph1603mcpsimp"></a><a name="ph1603mcpsimp"></a>帧率属性。</span>具体描述请参见“系统控制”章节。</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   sync\_pipe\_en如果打开，AVS会根据各路输入图像PTS进行同步，找出PTS最为接近的一组图像进行拼接，会导致AVS占用的VB数目增多，如果有同步要求的拼接使能同步，如果对拼接同步要求不高关闭同步可以达到节省内存的目的。
-   lut、gain\_attr以及out\_attr只有在[OT\_AVS\_MODE\_BLEND](ot_avs_mode.md#OT_AVS_MODE_BLEND)模式下才会有效。

【相关数据类型及接口】

无。

### ot\_avs\_chn\_attr<a name="ZH-CN_TOPIC_0000002408098230"></a>

【说明】

定义AVS通道属性。

【定义】

```
typedef struct {
    td_u32 width; 
    td_u32 height; 
    ot_compress_mode compress_mode; 
    ot_dynamic_range dynamic_range; 
    td_u32 depth; 
} ot_avs_chn_attr;
```

【成员】

<a name="table1624mcpsimp"></a>
<table><thead align="left"><tr id="row1629mcpsimp"><th class="cellrowborder" valign="top" width="32%" id="mcps1.1.3.1.1"><p id="p1631mcpsimp"><a name="p1631mcpsimp"></a><a name="p1631mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="68%" id="mcps1.1.3.1.2"><p id="p1633mcpsimp"><a name="p1633mcpsimp"></a><a name="p1633mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1635mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1637mcpsimp"><a name="p1637mcpsimp"></a><a name="p1637mcpsimp"></a>width</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1639mcpsimp"><a name="p1639mcpsimp"></a><a name="p1639mcpsimp"></a>通道宽度，单位：像素，要求4对齐。</p>
</td>
</tr>
<tr id="row1640mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1642mcpsimp"><a name="p1642mcpsimp"></a><a name="p1642mcpsimp"></a>height</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1644mcpsimp"><a name="p1644mcpsimp"></a><a name="p1644mcpsimp"></a>通道高度，单位：像素，要求4对齐。</p>
</td>
</tr>
<tr id="row1645mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1647mcpsimp"><a name="p1647mcpsimp"></a><a name="p1647mcpsimp"></a>compress_mode</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p id="p1649mcpsimp"><a name="p1649mcpsimp"></a><a name="p1649mcpsimp"></a><span xml:lang="sv-SE" id="ph1650mcpsimp"><a name="ph1650mcpsimp"></a><a name="ph1650mcpsimp"></a>通道压缩模式。</span>具体描述请参见“系统控制”章节。</p>
</td>
</tr>
<tr id="row1651mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1653mcpsimp"><a name="p1653mcpsimp"></a><a name="p1653mcpsimp"></a>dynamic_range</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p id="p1655mcpsimp"><a name="p1655mcpsimp"></a><a name="p1655mcpsimp"></a><span xml:lang="sv-SE" id="ph1656mcpsimp"><a name="ph1656mcpsimp"></a><a name="ph1656mcpsimp"></a>通道动态范围。</span>具体描述请参见“系统控制”章节。</p>
</td>
</tr>
<tr id="row1657mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p xml:lang="sv-SE" id="p1659mcpsimp"><a name="p1659mcpsimp"></a><a name="p1659mcpsimp"></a>depth</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1661mcpsimp"><a name="p1661mcpsimp"></a><a name="p1661mcpsimp"></a>通道图像队列深度。取值范围：[0, 8]</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   width、height和dynamic\_range只有在[OT\_AVS\_MODE\_BLEND](ot_avs_mode.md#OT_AVS_MODE_BLEND)拼接模式下才会生效。
-   仅通道0支持OT\_COMPRESS\_MODE\_SEG压缩，其余通道不支持压缩。
-   其余通道的高度不能小于通道0的高度的15分之1，不能大于通道0的高度。
-   其余通道的宽度不能小于通道0的宽度的15分之1，不能大于通道0的宽度的2分之1。
-   通道图像队列深度在获取通道图像的时候才有用，如没必要，建议设置为0，否则会导致AVS模块VB占用的增加。
-   通道0的动态范围设置无效，通道0输出的动态范围和输入图相同。
-   SS928V100的非0通道的动态范围只能设置为SDR8。
-   如果AVS使能的通道没有绑定后端，并且depth为0时，AVS会停止工作。
-   SS927V100所有的[OT\_AVS\_MODE\_BLEND](ot_avs_mode.md#OT_AVS_MODE_BLEND)模式拼接组通道0的输出总面积最大为3840x2160，SS928V100无此限制。

【相关数据类型及接口】

无。

### ot\_avs\_mod\_param<a name="ZH-CN_TOPIC_0000002408258302"></a>

【说明】

定义AVS模块参数。

【定义】

```
typedef struct {
    td_u32 working_set_size;
} ot_avs_mod_param;
```

【成员】

<a name="table1685mcpsimp"></a>
<table><thead align="left"><tr id="row1690mcpsimp"><th class="cellrowborder" valign="top" width="36%" id="mcps1.1.3.1.1"><p id="p1692mcpsimp"><a name="p1692mcpsimp"></a><a name="p1692mcpsimp"></a>成员名称</p>
</th>
<th class="cellrowborder" valign="top" width="64%" id="mcps1.1.3.1.2"><p id="p1694mcpsimp"><a name="p1694mcpsimp"></a><a name="p1694mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1696mcpsimp"><td class="cellrowborder" valign="top" width="36%" headers="mcps1.1.3.1.1 "><p id="p1698mcpsimp"><a name="p1698mcpsimp"></a><a name="p1698mcpsimp"></a>working_set_size</p>
</td>
<td class="cellrowborder" valign="top" width="64%" headers="mcps1.1.3.1.2 "><p xml:lang="sv-SE" id="p1700mcpsimp"><a name="p1700mcpsimp"></a><a name="p1700mcpsimp"></a>AVS工作空间的大小，单位KB，默认值为204800。取值范围：(0, 4000000]</p>
</td>
</tr>
</tbody>
</table>

【注意事项】

-   working\_set\_size如果为非4对齐，内部会自动向上4对齐。
-   AVS的工作空间用于AVS内部的DDR交互，working\_set\_size即用于配置交互DDR的大小。
-   AVS会根据配置的working\_set\_size大小来自适应交互数据的压缩率。内部使用比特率来表示数据量，非压缩时原始数据大小为80bits，该值越小说明压缩率越大，性能越好，但是图像质量牺牲越大。AVS内部压缩可根据比特率大小自动切换有损及无损压缩。比特率最小为30bits，此时压缩率最大；设置的working\_set\_size计算得到的比特率比30bit小会报错；最大没有限制，当比特率大于106bits时，此时可保证调用无损压缩；推荐使用比特率为40bits，即平均压缩率约为50%，此时性能较佳，且图像质量基本不下降。比特率与working\_set\_size的转换公式如下：

    W= I \* \(R \* A + 80 \* B + 25179639\) / 2^12 \(KB\)

    W为working\_set\_size；

    R为比特率；

    I为输入Pipe数；

    A = 1344/4096 \* out\_width \* out\_height + 168/64 \* \(out\_width + out\_height\) + 27

    B = 21/4096 \* out\_width \* out\_height + 21/64 \* \(out\_width + out\_height \) + 27

    立方体投影模式下，out\_width和out\_height为立方体投影的单个面的边长；其他投影模式下，out\_width为通道0的宽度，out\_height为通道0的高度；

    以双鱼眼拼接为例，如果通道0的宽高为6000\*3000，比特率为40bits，则working\_set\_size的计算如下：

    A = 1344/4096 \* 6000 \* 3000 + 168/64 \* \(6000 + 3000\) + 27= 5929902

    B = 21/4096 \* 6000 \* 3000 + 21/64 \* \(6000 + 3000\) + 27= 95265.28125

    W = 2 \* \(40 \* 5929902 + 80 \* 95265.28125 + 25179639\)/2^12 = 131834.43KB

【相关数据类型及接口】

无。

## 错误码<a name="ZH-CN_TOPIC_0000002441697557"></a>

全景拼接API错误码如下所示。

**表 1**  AVS API错误码

<a name="_Ref248290030"></a>
<table><thead align="left"><tr id="row1728mcpsimp"><th class="cellrowborder" valign="top" width="20%" id="mcps1.2.4.1.1"><p id="p1730mcpsimp"><a name="p1730mcpsimp"></a><a name="p1730mcpsimp"></a>错误代码</p>
</th>
<th class="cellrowborder" valign="top" width="46%" id="mcps1.2.4.1.2"><p id="p1732mcpsimp"><a name="p1732mcpsimp"></a><a name="p1732mcpsimp"></a>宏定义</p>
</th>
<th class="cellrowborder" valign="top" width="34%" id="mcps1.2.4.1.3"><p id="p1734mcpsimp"><a name="p1734mcpsimp"></a><a name="p1734mcpsimp"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row1736mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1738mcpsimp"><a name="p1738mcpsimp"></a><a name="p1738mcpsimp"></a>0xa0068001</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1740mcpsimp"><a name="p1740mcpsimp"></a><a name="p1740mcpsimp"></a>OT_ERR_AVS_INVALID_DEVID</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1742mcpsimp"><a name="p1742mcpsimp"></a><a name="p1742mcpsimp"></a>AVS GROUP号无效</p>
</td>
</tr>
<tr id="row1743mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1745mcpsimp"><a name="p1745mcpsimp"></a><a name="p1745mcpsimp"></a>0xa0068003</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="pt-BR" id="p1747mcpsimp"><a name="p1747mcpsimp"></a><a name="p1747mcpsimp"></a>OT_ERR_AVS_INVALID_CHNID</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1749mcpsimp"><a name="p1749mcpsimp"></a><a name="p1749mcpsimp"></a>AVS通道号无效</p>
</td>
</tr>
<tr id="row1750mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1752mcpsimp"><a name="p1752mcpsimp"></a><a name="p1752mcpsimp"></a>0xa0068007</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1754mcpsimp"><a name="p1754mcpsimp"></a><a name="p1754mcpsimp"></a>OT_ERR_AVS_ILLEGAL_PARAM</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1756mcpsimp"><a name="p1756mcpsimp"></a><a name="p1756mcpsimp"></a>AVS参数设置无效</p>
</td>
</tr>
<tr id="row1757mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1759mcpsimp"><a name="p1759mcpsimp"></a><a name="p1759mcpsimp"></a>0xa0068008</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1761mcpsimp"><a name="p1761mcpsimp"></a><a name="p1761mcpsimp"></a>OT_ERR_AVS_EXIST</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1763mcpsimp"><a name="p1763mcpsimp"></a><a name="p1763mcpsimp"></a>AVS GROUP已创建</p>
</td>
</tr>
<tr id="row1764mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1766mcpsimp"><a name="p1766mcpsimp"></a><a name="p1766mcpsimp"></a>0xa0068009</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1768mcpsimp"><a name="p1768mcpsimp"></a><a name="p1768mcpsimp"></a>OT_ERR_AVS_UNEXIST</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1770mcpsimp"><a name="p1770mcpsimp"></a><a name="p1770mcpsimp"></a>AVS GROUP未创建</p>
</td>
</tr>
<tr id="row1771mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1773mcpsimp"><a name="p1773mcpsimp"></a><a name="p1773mcpsimp"></a>0xa006800a</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1775mcpsimp"><a name="p1775mcpsimp"></a><a name="p1775mcpsimp"></a>OT_ERR_AVS_NULL_PTR</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1777mcpsimp"><a name="p1777mcpsimp"></a><a name="p1777mcpsimp"></a>输入参数空指针错误</p>
</td>
</tr>
<tr id="row1778mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1780mcpsimp"><a name="p1780mcpsimp"></a><a name="p1780mcpsimp"></a>0xa006800c</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="sv-SE" id="p1782mcpsimp"><a name="p1782mcpsimp"></a><a name="p1782mcpsimp"></a>OT_ERR_AVS_NOT_SUPPORT</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1784mcpsimp"><a name="p1784mcpsimp"></a><a name="p1784mcpsimp"></a>操作不支持</p>
</td>
</tr>
<tr id="row1785mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1787mcpsimp"><a name="p1787mcpsimp"></a><a name="p1787mcpsimp"></a>0xa006800d</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p id="p1789mcpsimp"><a name="p1789mcpsimp"></a><a name="p1789mcpsimp"></a>OT_ERR_AVS_NOT_PERM</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1791mcpsimp"><a name="p1791mcpsimp"></a><a name="p1791mcpsimp"></a>操作不允许</p>
</td>
</tr>
<tr id="row1792mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1794mcpsimp"><a name="p1794mcpsimp"></a><a name="p1794mcpsimp"></a>0xa0068002</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p id="p1796mcpsimp"><a name="p1796mcpsimp"></a><a name="p1796mcpsimp"></a>OT_ERR_AVS_INVALID_PIPEID</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1798mcpsimp"><a name="p1798mcpsimp"></a><a name="p1798mcpsimp"></a>AVS PIPE号无效</p>
</td>
</tr>
<tr id="row1799mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1801mcpsimp"><a name="p1801mcpsimp"></a><a name="p1801mcpsimp"></a>0xa0068014</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p id="p1803mcpsimp"><a name="p1803mcpsimp"></a><a name="p1803mcpsimp"></a>OT_ERR_AVS_NO_MEM</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1805mcpsimp"><a name="p1805mcpsimp"></a><a name="p1805mcpsimp"></a>分配内存失败</p>
</td>
</tr>
<tr id="row1806mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1808mcpsimp"><a name="p1808mcpsimp"></a><a name="p1808mcpsimp"></a>0xa0068015</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="da-DK" id="p1810mcpsimp"><a name="p1810mcpsimp"></a><a name="p1810mcpsimp"></a>OT_ERR_AVS_NO_BUF</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1812mcpsimp"><a name="p1812mcpsimp"></a><a name="p1812mcpsimp"></a>分配BUF失败</p>
</td>
</tr>
<tr id="row1813mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1815mcpsimp"><a name="p1815mcpsimp"></a><a name="p1815mcpsimp"></a>0xa0068016</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p xml:lang="da-DK" id="p1817mcpsimp"><a name="p1817mcpsimp"></a><a name="p1817mcpsimp"></a>OT_ERR_AVS_BUF_EMPTY</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1819mcpsimp"><a name="p1819mcpsimp"></a><a name="p1819mcpsimp"></a>图像队列为空</p>
</td>
</tr>
<tr id="row1820mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1822mcpsimp"><a name="p1822mcpsimp"></a><a name="p1822mcpsimp"></a>0xa0068018</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p id="p1824mcpsimp"><a name="p1824mcpsimp"></a><a name="p1824mcpsimp"></a>OT_ERR_AVS_NOT_READY</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1826mcpsimp"><a name="p1826mcpsimp"></a><a name="p1826mcpsimp"></a>AVS系统未初始化</p>
</td>
</tr>
<tr id="row1827mcpsimp"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.4.1.1 "><p id="p1829mcpsimp"><a name="p1829mcpsimp"></a><a name="p1829mcpsimp"></a>0xa0068022</p>
</td>
<td class="cellrowborder" valign="top" width="46%" headers="mcps1.2.4.1.2 "><p id="p1831mcpsimp"><a name="p1831mcpsimp"></a><a name="p1831mcpsimp"></a>OT_ERR_AVS_BUSY</p>
</td>
<td class="cellrowborder" valign="top" width="34%" headers="mcps1.2.4.1.3 "><p id="p1833mcpsimp"><a name="p1833mcpsimp"></a><a name="p1833mcpsimp"></a>AVS系统忙</p>
</td>
</tr>
</tbody>
</table>

